Qiitaいいね数ランキング (1000位まで)

Markdown記法のチートシートです。
本ページではQiitaで使用可能なMarkdownのみ掲載しているため、一部原文と異なります。
Markdownの原文については、[Daring Fireball: Markdown Syntax Documentation]
(http://daringfireball.net/projects/markdown/syntax.php)をご覧下さい。
また、コードに関する記法は[GitHub Flavored Markdown](http://github.github.com/github-flavored-markdown/)に準拠しています。
Qiitaでシンタックスハイライト可能な言語一覧については、 [シンタックスハイライト可能な言語](http://qiita.com/Qiita/items/e84f5aad7757afce82ba) をご覧下さい。

## Code - コードの挿入

たとえば、Rubyで記述したコードをファイル名「qiita.rb」として投稿したいときは、 **バッククオート** を使用して以下のように投稿するとシンタックスハイライトが適用されます。
**コードブロック上下に空行を挿入しないと正しく表示されないことがあります。**

> (空行)
> \`\`\`ruby:qiita.rb
> puts 'The best way to log and share programmers knowledge.'
> \`\`\`
> (空行)

**結果**

```ruby:qiita.rb
puts 'The best way to log and share programmers knowledge.'
```

また、コードをインライン表示することも可能です。

> \` puts 'Qiita'` はプログラマのための技術情報共有サービスです。

**結果**

` puts 'Qiita'` はプログラマのための技術情報共有サービスです。

インラインコードがn個連続するバッククオートを含む場合、n+1連続のバッククオートで囲みます。

> \`\` \`バッククオート\` \`\` や \`\`\` \`\`2連続バッククオート\`\` \`\`\` も記述できます。

**結果**

`` `バッククオート` `` や ``` ``2連続バッククオート`` ``` も記述できます。

インラインコードの中身が [CSS の `<color>` 型](https://developer.mozilla.org/ja/docs/Web/CSS/color_value)の RGB 16進数表記, `rgb()`, `rgba()`, `hsl()`, `hsla()` 場合横にその色が表示されます。

> \`#ffce44\`
> \`rgb(255,0,0)\`
> \`rgba(0,255,0,0.4)\`
> \`hsl(100, 10%, 10%)\`
> \`hsla(100, 24%, 40%, 0.5)\`

**結果**

`#ffce44`
`rgb(255,0,0)`
`rgba(0,255,0,0.4)`
`hsl(100, 10%, 10%)`
`hsla(100, 24%, 40%, 0.5)`

### Gist連携について

##### GitHubアカウントでQiitaにログインされている場合

投稿時、Octocatアイコンにチェックを入れていただくと連携を行います。
コードを含むアイテムを投稿するとコード部分を抽出し、同じ内容がGistにも投稿される仕組みになっています。

Gistとの連携は、

* コードの投稿
* Qiita側でのコードの編集

の２点について連携しています。
Gist側でコードを編集されても、 **Qiitaには反映されません** のでご注意下さい。

## Format Text - テキストの装飾

### Headers - 見出し

* \# これはH1タグです
* \## これはH2タグです
* \###### これはH6タグです

### Emphasis - 強調・強勢

```markdown
_ か * で囲むとHTMLのemタグになります。Qiitaでは*イタリック体*になります。
__ か ** で囲むとHTMLのstrongタグになります。Qiitaでは**太字**になります。
```

_ か * で囲むとHTMLのemタグになります。Qiitaでは*イタリック体*になります。
__ か ** で囲むとHTMLのstrongタグになります。Qiitaでは**太字**になります。

### Strikethrough - 打ち消し線

```markdown
打ち消し線を使うには ~~ で囲みます。 ~~打ち消し~~
```

打ち消し線を使うには ~~ で囲みます。 ~~打ち消し~~

イタリックや太文字と同様に前後に **半角スペース** か **改行文字** が必要です。

### Details - 折りたたみ

```markdown
追加情報としたい内容を、detailsタグで囲みます。そして、要約として表示したい文章をsummaryタグで記載します。

Qiitaとは

<details><summary>Qiita(キータ)は、プログラマのための技術情報共有サービスです。</summary>プログラミングに関することをどんどん投稿して、知識を記録、共有しましょう。
Qiitaに投稿すると、自分のコードやノウハウを見やすい形で残すことができます。
技術情報はテキストファイルへのメモではなく、タグを付けた文章、シンタックスハイライトされたコードで保存することで初めて再利用可能な知識になる、そうQiitaでは考えています。</details>
```

追加情報としたい内容を、detailsタグで囲みます。そして、要約として表示したい文章をsummaryタグで記載します。

Qiitaとは

<details><summary>Qiita(キータ)は、プログラマのための技術情報共有サービスです。</summary>
プログラミングに関することをどんどん投稿して、知識を記録、共有しましょう。
Qiitaに投稿すると、自分のコードやノウハウを見やすい形で残すことができます。
技術情報はテキストファイルへのメモではなく、タグを付けた文章、シンタックスハイライトされたコードで保存することで初めて再利用可能な知識になる、そうQiitaでは考えています。</details>

## Lists - リスト

### Disc型

* 文頭に「*」「+」「-」のいずれかを入れるとDisc型リストになります
* 要点をまとめる際に便利です
* リストを挿入する際は、 **リストの上下に空行がないと正しく表示されません。また「*」「+」「-」の後にはスペースが必要です**

### Decimal型

1. 文頭に「数字.」を入れるとDecimal型リストになります
2. 後からの挿入/移動を考慮して、1. 2. 3. と順番にするのではなく、1. 1. 1. という風に同じ数字にしておくといい具合です。
3. リストを挿入する際は、 **リストの上下に空行がないと正しく表示されません。また「数字.」の後にはスペースが必要です**

### Definition型

HTMLの`<dl>`タグをそのまま使うことで実現できます。

```html
<dl>
<dt>リンゴ</dt>
<dd>赤いフルーツ</dd>
<dt>オレンジ</dt>
<dd>橙色のフルーツ</dd>
</dl>
```
次のようになります。

<dl>
<dt>リンゴ</dt>
<dd>赤いフルーツ</dd>
<dt>オレンジ</dt>
<dd>橙色フルーツ</dd>
</dl>

注意するべきは、Definition型のリスト内ではMarkdown記法が使えないということです。例えば以下のように書いてはなりません。

```html
<dl>
<dt>リンゴ</dt>
<dd> とても **赤い** フルーツ </dd>
</dl>
```

次のようになってしまいます。

<dl>
<dt>リンゴ</dt>
<dd> とても **赤い** フルーツ </dd>
</dl>

Definition型リスト内ではMarkdown記法ではなくて、HTMLタグを使って修飾しなければならないので、正しくは次のようになります。

```html
<dl>
<dt>リンゴ</dt>
<dd> とても<strong>赤い</strong>フルーツ </dd>
</dl>
```

<dl>
<dt>リンゴ</dt>
<dd> とても<strong>赤い</strong>フルーツ</dd>
</dl>

Markdown記法とHTMLタグの対応は次のようになっています。

| 修飾 | Markdown | HTML |
|:----------:|:---------------:|:------------------------:|
| ボールド | `** **` | `<strong></strong>` |
| イタリック | `_ _` | `<em></em>` |
| コード | <code>``</code> | `<code></code>` |
| リンク | `[text](url)` | `<a href="url">text</a>` |

### Checkbox型

Disc型の記述の後ろに[ ]を入れるとチェックボックスが生成されます。
チェックが入った状態のボックスを生成する場合は[x]を入力します。
**前後にスペースが必要です。**

```md
- [ ] タスク1
- [x] タスク2
```

- [ ] タスク1
- [x] タスク2




## Blockquotes - 引用

> \> 文頭に>を置くことで引用になります。
> \> 複数行にまたがる場合、改行のたびにこの記号を置く必要があります。
> \> **引用の上下にはリストと同じく空行がないと正しく表示されません**
> \> 引用の中に別のMarkdownを使用することも可能です。

> > これはネストされた引用です。

## Horizontal rules - 水平線

下記は全て水平線として表示されます

> \* * *
> \***
> \*****
> \- - -
> \---------------------------------------

## Links - リンク

* \[リンクテキスト](URL "タイトル")
* タイトル付きのリンクを投稿できます。

**例**

> *Markdown:* \[Qiita]\(http://qiita.com "Qiita")
> *結果:* [Qiita](http://qiita.com "Qiita")

* \[リンクテキスト](URL)
* こちらはタイトル無しのリンクになります。

**例**

> *Markdown:* \[Qiita]\(http://qiita.com)
> *結果:* [Qiita](http://qiita.com)

- \[リンクテキスト]\[名前]
- \[名前]:URL
- 同じURLへのリンクを複数箇所に設定することができます

**例**

>
*Markdown:*
\[ここ]\[link-1] と \[この]\[link-1] リンクは同じになります。
\[link-1][\] も可能です。
\[link-1]:http://qiita.com/drafts/c686397e4a0f4f11683d
>
*結果:*
[ここ][link-1] と [この][link-1] リンクは同じになります。
[link-1][] も可能です。
[link-1]:http://qiita.com/drafts/c686397e4a0f4f11683d

## Images - 画像埋め込み

* \![代替テキスト]\(画像のURL)
* タイトル無しの画像を埋め込む
* \![代替テキスト]\(画像のURL "画像タイトル")
* タイトル有りの画像を埋め込む

**例**

> *Markdown:* \![Qiita]\(https://qiita-image-store.s3.amazonaws.com/0/45617/015bd058-7ea0-e6a5-b9cb-36a4fb38e59c.png "Qiita")

> *結果:*

> 

## テーブル記法
### 入力補完を利用する場合

### 手動で入力する場合
```
| Left align | Right align | Center align |
|:-----------|------------:|:------------:|
| This | This | This |
| column | column | column |
| will | will | will |
| be | be | be |
| left | right | center |
| aligned | aligned | aligned |
```

上記のように書くと，以下のように表示されます．

| Left align | Right align | Center align |
|:-----------|------------:|:------------:|
| This | This | This |
| column | column | column |
| will | will | will |
| be | be | be |
| left | right | center |
| aligned | aligned | aligned |

## 数式の挿入

コードブロックの言語指定に "math" を指定することでTeX記法を用いて数式を記述することができます。

> \`\`\`math
> \left( \sum_{k=1}^n a_k b_k \right)^{\!\!2} \leq
> \left( \sum_{k=1}^n a_k^2 \right) \left( \sum_{k=1}^n b_k^2 \right)
> \`\`\`

```math
\left( \sum_{k=1}^n a_k b_k \right)^{\!\!2} \leq
\left( \sum_{k=1}^n a_k^2 \right) \left( \sum_{k=1}^n b_k^2 \right)
```

`$2^3$` のように数式を "$" で挟むと行中に数式を埋め込むこともできます。

> x^2 + y^2 = 1 をインライン表示すると $x^2 + y^2 = 1$ になります。

ただしインライン数式の中でコントロールシンボル（`\{`のような、バックスラッシュの後に記号が続くもの）を使うと、後述のバックスラッシュによるMarkdownのエスケープと衝突してしまいます。

```
$a = \{1, 2, 3\}$
```

> $a = \{1, 2, 3\}$

なので次のように二つのバックスラッシュを使います。

```
$a = \\{1, 2, 3\\}$
```

> $a = \\{1, 2, 3\\}$

## 目次(TOC)の自動挿入

目次は記事内の見出しを元に自動生成し、右上に自動挿入されます。詳細は[目次機能の紹介記事](http://blog.qiita.com/post/77055935852/qiita-toc)をご覧ください。

## 注釈
本文中に`[^1]`や`[^example]`のように文字列を記述することで、脚注へのリンクを表現できます。注釈内容は、同じく本文中に `[^1]: ...` というように記述します[^1]。

[^1]: 注釈内容を記述する位置は、本文の途中でも末尾でも構いません。

## 絵文字
厳密には Markdown 記法の外ですが、`:` で囲って、絵文字を埋め込めます。

**例**

```
\:kissing_closed_eyes: chu☆
```

> \:kissing_closed_eyes: chu☆


絵文字チートシート
http://www.emoji-cheat-sheet.com/


## その他

バックスラッシュ[\\]をMarkdownの前に挿入することで、Markdownをエスケープ(無効化)することができます。

**例**

> \# H1
> エスケープされています

また本文では一部のHTMLタグも利用可能です。

[これ知らないプログラマって損してんなって思う汎用的なツール](http://qiita.com/puriketu99/items/f75d42f1ff669b924ec1)のコメントに寄せられたツールを分類分けしてみました。

* 解説は、ほぼコメントに寄せられた内容のコピペです。
* URLのみの記述は公式サイト(か、ほぼ公式サイトと化しているサイト)
* 公式サイトとは別に、ページタイトルだけでツールを説明しきっているページへのリンクも付けておきました。類似ページが複数ある場合は、はてブのブックマーク数が多いものを選びました。
* 知らないツールもあるので、分類がいいかげんなところもあると思います。何か気づいたらコメントください。
* 解説が不十分なツールについても、補足（コピペで本文に取り込める体裁だとありがたい）を頂けると助かります！
* 元ネタの投稿は現在進行形なので、随時取り込んでいきたいと思います。




---

# エディタ


### vim

自分はVimmerなんで、Vimを推しておきます。Vimがあれば大抵の事が出来ると思ってます。
が、Vimは習得に時間がかかるという難点があります。

エディタプラグイン

* neocomplcache.vim
* quickrun.vim
* vimproc + quickrun
* unite.vim

### MacVim


### Emacs

VIM, Emacs は別格って感じですね・・・

エディタプラグイン

* anything.el

### CocoaEmacs


### Mou

Markdownを書くためのエディタ。

* http://mouapp.com/
* [ リアルタイムプレビューができるMarkdownエディタ『Mou』 | Macの手書き説明書](http://veadardiary.blog29.fc2.com/blog-entry-3492.html)


### Sublime Text 3

https://sublimetext.com/3

### CotEditor

フリー。超軽量なエディター。
簡単な文章修正とかに向いてる。

### Coda

https://panic.com/jp/coda/
シェア。エディター＋IDE的な感じ。デザインを確認しながら編集できる。FTPやSSHとかSVNとかも同梱されていてデザイナーはこれで十分。

### TextWrangler

https://itunes.apple.com/jp/app/textwrangler/id404010395

### Espresso

http://espressoapp.com/
Espresso はリアルタイムでCSSをプレビューしながら書けたりするエディタ。


### JSON Editor

サクっとJSONを整形してくれる

---

# IDE(統合開発環境)



### Xcode

iPhoneアプリを開発する気がなくても入れておくと、差分を簡単に扱えるFileMergeアプリやopendiffコマンドなどおまけが付いてくるのでオススメ

* https://developer.apple.com/xcode/

### Eclipse

Eclipse とか NetBeans とかもとりあえず使ってみる派。で、どっちがいいというのを決めるより「これは何が優れているか」をみて、シーンによって起動するのを変えてしまう。

* http://www.eclipse.org/

### NetBeans

Eclipse とか NetBeans とかもとりあえず使ってみる派。で、どっちがいいというのを決めるより「これは何が優れているか」をみて、シーンによって起動するのを変えてしまう。

* http://ja.netbeans.org/


### PhpStrom

PHPやJavaScriptをはじめとしたウェブ向けのIDE。

* http://www.jetbrains.com/phpstorm/
* [最強のJavaScript IDE「WebStorm」の姉妹品「PhpStorm」はPHP IDEとして最高だった ::ハブろぐ](http://havelog.ayumusato.com/computer/software/e173-phpstorm-best-ide.html)


### Cloud9

まだ荒削りだけど、ブラウザで実行できるIDE。GitHubやBitbucketなんかと連動。

* http://c9.io/

### WebStorm

現行のIDEの中ではJavaScript回りの環境が最強。姉妹品のPHPStormも評判良いです。
リファクタとか超簡単に出来たりします。が、有料です。その価値はあると思いますけど…。

* http://www.jetbrains.com/webstorm/index.html
* [最強のJavaScript IDE 「WebStorm」を使ってみた](http://efcl.info/2010/1027/res2023/)

### Nide

node.jsのIDE

* http://coreh.github.com/nide/
* [Node.js向けのWebベースIDE「Nide 0.2」がリリース - SourceForge.JP Magazine : オープンソースの話題満載](http://sourceforge.jp/magazine/12/01/17/080233)





---

# SQL, DB

### Sequel Pro

MySQLクライアント。phpMyAdminがいらなくなりました。

* http://www.sequelpro.com/
* [高機能なMySQLフロントエンド「Sequel Pro」 - MOONGIFT](http://www.moongift.jp/2008/06/sequel_pro/)

### Navicat

MySQLクライアント。

* http://www.navicat.jp/
* [便利なGUIのMySQLフロントエンド「Navicat for MySQL Lite」 - MOONGIFT](http://www.moongift.jp/2008/02/navicat_for_mysql_lite/)

### MySQLWorkbench

MySQLのクライアントは MySQLWorkbench を使っています。
EER図も描けるからデータベースの設計にも使える。

* http://www-jp.mysql.com/products/workbench/

### HeidiSQL

Windows向けMySQLのクライアントですが、HeidiSQL
JDBC/ODBC等なしにこれ単体で接続でき、スプレッドシートを順次開いていくかたちでのブラウジングができる。
そのため、「実際にDBのデータを見ながらデータをいじる」というのが直感的にでき、非常に便利。
SSHトンネル接続や、サーバ間のデータダンプ＆リストアもできるため、運用作業はだいたいこれで完結できる。
ただ、若干不安定なので、ミッションクリティカルな作業には向いてないかも。
（そういうのはサーバ上でやれよ、と言われそうですが…）

* http://www.heidisql.com/


### adminer

phpMyAdminと同じくブラウザベースのDBクライアント。
1ファイルでphpが動く環境ならOK、なにより軽いから重宝してる。
MySQL,PostgreSQL, SQLite, MS SQL,Oracleと意外に相手を問わないのになぜかマイナーなんだよな～。

* http://www.adminer.org/


### SQLEditor

ER図作成ツール。生SQLやActiveRecord Modelを書き出せる

### Base.app

SQlite用GUI管理ツール

### ERMaster

DB管理ツール。
EclipseのプラグインですがDB管理＋ドキュメント化が非常に楽になります。

### The SQLite Sorcerer

SQLite用のクライアント。AIR製。

* http://afoucal.free.fr/index.php/applications/sqlite-sorcerer/


---


# PHP


### MAMP

* http://www.mamp.info/en/index.html

### xhprof

php で書かれたWebアプリケーションのボトルネック調査に必須

### xdebug

### PHPUnit

使えるテストフレームワークがこれしかない…

### Phing

php のビルドツール，テスト環境や本番などの環境ごとのブートストラップ指定や，結合テストの設定に



---

# Ruby


### travisCI

継続インテグレーション

### bundler

アプリケーション毎に必要な Gem を管理できる．デプロイ先の構築に便利

### Capistrano

デプロイツール，PHP とか他の言語で書かれたアプリケーションも設定次第でこれでデプロイできる

### Pry

irb から乗り換えた


### watchr

### guard

### gist

---

# Java

JavaDecompiler


---

# JavaScript

### node.js

JavaScriptの対話実行環境 とにかく速くJSの動作をチェックしたい時に便利

* http://nodejs.org/
* [サーバサイドJavaScriptの本命「Node.js」の基礎知識（1/3）- ＠IT](http://www.atmarkit.co.jp/fwcr/rensai2/nodejs01/01.html)

### SpiderMonkey

JavaScriptの対話実行環境 とにかく速くJSの動作をチェックしたい時に便利

* https://developer.mozilla.org/ja/SpiderMonkey

### ringo.js

JavaScriptの対話実行環境 とにかく速くJSの動作をチェックしたい時に便利

* http://ringojs.org/

### jsPerf

JavaScriptのベンチマーク取れるサイト。jsのベンチマークをとって公開するのに便利。

* http://jsperf.com/

### jsFiddle

ブラウザ内でJavaScriptの実行・HTML/CSSのマークアップなんかが試せる

* http://jsfiddle.net/


### Google Closure Compiler

JavaScriptをミニファイすることがあれば、Google Closure Compiler

* http://code.google.com/p/closure-compiler/
* [Google製JavaScript最適化ツール「Closure Compiler」 - MOONGIFT](http://www.moongift.jp/2009/11/closure-compiler/)

### YUI Compressor

JavaScriptもCSSもミニファイすることがあれば、YUI Compressor

* http://developer.yahoo.com/yui/compressor/
* [YUI Compressorで簡単にjavascriptとCSSを圧縮 - Affirmative Way](http://d.hatena.ne.jp/cos31/20080116/1200504657)


### impress.js

* http://bartaz.github.com/impress.js/
* [impress.jsライクなダイナミックなプレゼンテーションを作成するjQuery依存タイプのライブラリ・jmpress.js - かちびと. net](http://kachibito.net/web-design/jmpress-js.html)


### enchant.js

* http://enchantjs.com/ja/?s=ja
* [Monaca + enchant.js でお手軽スマフォゲームアプリ開発 : アシアルブログ](http://blog.asial.co.jp/858)

* gl.enchant.js
* [wise9 &rsaquo; 3D野郎は寄ってたかれ!WebGLでグリグリ遊べるgl.enchant.jsがついにβ公開!](http://wise9.jp/archives/6245)


### npm

### forever

### coffee-script

### rvm

### nvm

### nave

----

# Python

### pypy

pythonで書いたプログラムがちょっと遅いなと思ったらとりあえず一回使ってみる(djangoが動くので関係してますよね？)。

* http://pypy.org/

### virtualenv, virtualenvwrapper, pythonbrew

pythonだとvirtualenv, virtualenvwrapper。最近では代わりにpythonbrewは絶対入れる。

* http://pypi.python.org/pypi/virtualenv
* http://pypi.python.org/pypi/virtualenvwrapper
* https://github.com/utahta/pythonbrew
* [virtualenv, virtualenvwrapper, pip を使う方法 - Ian Lewis](http://www.ianlewis.org/jp/virtualenv-pip-fabric)
* [Pythonのバージョンを管理するツール、pythonbrewを作ってみた | ninxit.blog](http://www.ninxit.com/blog/2010/10/04/python%E3%81%AE%E3%83%90%E3%83%BC%E3%82%B8%E3%83%A7%E3%83%B3%E3%82%92%E7%AE%A1%E7%90%86%E3%81%99%E3%82%8B%E3%83%84%E3%83%BC%E3%83%AB%E3%80%81pythonbrew%E3%82%92%E4%BD%9C%E3%81%A3%E3%81%A6%E3%81%BF/)

### SimpleHTTPServer

Pythonだと、SimpleHTTPServerが便利だと思います。

* [Pythonを使って、１行でファイル共有Webサーバを立ち上げる - モジログ](http://mojix.org/2009/03/05/python_one_line_fileserver)


### pip
### ipython
### scipy
### werkzeug


---

# CSS, HTML, LESS



### Less.app

LESSを書くことがあれば LESS.app も便利です。

* http://incident57.com/less/
* [Sassよりラクチン，LESS.appで簡単CSSコンパイル生活！（Mac限定） ::ハブろぐ](http://havelog.ayumusato.com/computer/software/e218-less_better_css.html)


### Twitter Bootstrap

自分はプログラムに集中したい、でも見た目もそれなりになってたほうがいい、というときにはTwitter Bootstrapでテンプレートをサクっと作っておくといいかもです。

* http://twitter.github.com/bootstrap/
* [Twitter Bootstrapが大幅バージョンアップ！して凄まじいことに・・・ | IDEA*IDEA](http://www.ideaxidea.com/archives/2012/02/twitter_bootstrap_v2.html)


### zen-coding

HTML/CSSの入力支援。IDEがサポートしてたり、エディタにプラグインで組み込めたりする。

* https://github.com/sergeche/zen-coding


---


# テスト

### xUnit 系

[XUnitTestPatterns](http://xunitpatterns.com/) とか読んでおくとどの言語の xUnit 系テストフレームワークへの理解が進む

### xSpec 系

JBehave とか RSpec とか. PHP には無い．[Wikipedia英語版のBDDのページ](http://en.wikipedia.org/wiki/Behavior_Driven_Development)がわかりやすい

### QuickCheck 系

プログラム仕様そのものを記述し，ランダムな引数を与えて検証するテストフレームワーク．
オリジナルは Haskell からだが，[メジャーな言語ではけっこう既に実装されている](http://en.wikipedia.org/wiki/QuickCheck)．
Haskell 以外の言語で意欲的に実装を開発している[YelloSoftのページ](http://www.yellosoft.us/quickcheck) がわかりやすいかと

---

# ネットワーク

### Hoster

hostsファイルをGUIで設定するアプリ。

* http://www.redwinder.com/macapp/hoster/

### wireshark

あと wireshark, tshark は使い方覚えると超強力ですよ。

* http://www.wireshark.org/
* [パケットキャプチャツール「Wireshark」 - Wiresharkって？ - ネットワークエンジニアを目指して](http://www.itbook.info/study/wireshark1.html)
* [Tshark（キャプチャツール）](http://homepage2.nifty.com/protocol/tshark/index.html)

### HTTP Client

* http://ditchnet.org/httpclient/
* [Mac OSXのWeb開発のお供に「HTTP Client」 - MOONGIFT](http://www.moongift.jp/2008/12/http_client/)


### MockSMTP

仮想ローカルSMTP。ネットに繋がっていなくてもSMTPの挙動がチェックできる



---

# FTP, SSH, SCP


### ~/.ssh/config: SSHまわりの設定をまとめておくと大変便利

* [~/.ssh/config で簡単に複数ホストへのSSH接続を管理する - すぱぶらの日記](http://d.hatena.ne.jp/superbrothers/20090730/1248971671)


### PuTTY

WindowsのSSHは PuTTY 派なんですが、人にすすめるのは Poderosa ですね。

* http://yebisuya.dip.jp/Software/PuTTY/



### Poderosa

WindowsのSSHは PuTTY 派なんですが、人にすすめるのは Poderosa ですね。

* http://ja.poderosa.org/

### ClusterSSH

* http://sourceforge.net/projects/clusterssh/
* [しげふみメモ : Cluster SSHで複数ホストでコマンド同時実行](http://blog.livedoor.jp/hakin/archives/51564707.html)

### Transmit

リモート上のファイルをダブルクリックでローカルに保存→開く、ファイル保存→自動的にアップロード なんてのが出来て、ちょっとした開発には結構便利。あと、接続先のディレクトリをFinderにマウント出来る恐怖の機能とかも。もちろんssh等にも対応。


---

# grep



### rak

Ruby系のツールの rak コマンド。grep検索ツールです。

* [コードスニペットを検索するのにとても便利な「rak」のご紹介 - Seasons.NET](http://d.hatena.ne.jp/Seasons/20090615/1245091432)


### ack

better than grep

* http://betterthangrep.com/


### jvgrep

手前味噌ですがgrepでjvgrep。go言語で書かれているのでlinuxでもwindowsでも同じ動作。
日本語のエンコーディングはだいたいサポートしてるので、いろんなエンコーディングのファイルが混じった時のgrepや、通称駄目文字を含んだ正規表現でも正しく動きます。



### Tips

`export GREP_OPTIONS='--color=auto'`
でfgrep/egrep/grepしたときにマッチしたとき単語がカラフルにハイライト表示されるようになる

grep/fgrep/egrepの-oオプション。マッチした単語のみ抽出出来る、これはワンライナー書くときに使える。egrepは拡張正規表現なのでPerlとかRubyみたいに便利な正規表現使える。fgrepは固定文字列検索するときに早い
詳細: [単語抽出するちょっとしたテクニック - 技術メモ帳](http://d.hatena.ne.jp/lurker/20070131/1170201200)

---

# 統計処理

数万件程度のちょっとしたログをさくっと処理したい時に便利
中央値、標準偏差なんかも一発で出せる。データを元にヒストグラム、3Dのグラフ描画とかも


### R

* http://www.r-project.org/

### Octave

* http://www.gnu.org/software/octave/


---

# ターミナル


### TotalTerminal

Macのターミナルをショートカットキーですぐに呼び出せます。

* http://totalterminal.binaryage.com/
* [ホットキーでターミナルを呼び出す『TotalTerminal』 | Macの手書き説明書](http://veadardiary.blog29.fc2.com/blog-entry-3377.html)


### iTerm2

* http://www.iterm2.com/#/section/home
* [米LH編集部のイチオシのMacのターミナルエミュレータは『iTerm2』 : ライフハッカー［日本版］](http://www.lifehacker.jp/2011/11/111116maciterm2.html)


### percol

percol がターミナルで使える汎用的で便利なツールです。どう使うかでこちらの知識/センスが試されている気分になります。

* https://github.com/mooz/percol

---

# Subversion

### Cornerstone

SVNクライアント。

### Versions

SVNクライアント。

---

# git

### SmartGit (Windows)

Git クライアント

* http://www.syntevo.com/smartgit/index.html

### SourceTree

Git クライアント

* http://www.sourcetreeapp.com/

### GitHub

自分の書いたソースコードを公開。

* https://github.com/
* [とっても優しい github の使い方 - ￢￢日常日記](http://d.hatena.ne.jp/keita_yamaguchi/20080409/1207752188)

### tig

git使うならtigが無いと生きていけない。

* [コンソールから使える git ブラウザ、tig が超便利 - #生存戦略 、それは - subtech](http://subtech.g.hatena.ne.jp/secondlife/20101114/1289736508)



### GitX

* http://gitx.frim.nl/
* [Git リポジトリを視覚化するツール「GitX」 - kなんとかの日記](http://d.hatena.ne.jp/kwatch/20081021/1224608591)


### Tower

* http://www.git-tower.com/

### github for mac

* http://mac.github.com/

---

# ブラウザ

### SRWare Iron

UserAgentが変えられるChrome的な使い方をしてます



---

# パッケージ管理

### MacPorts

フリー。パッケージ管理ツール。コンパイルに時間かかるけど昔から使ってるから手放せないツール。

### Homebrew

UNIXのコマンドなどをサクっと入れられます。

* http://mxcl.github.com/homebrew/
* [MacPortsより使いやすい！？パッケージ管理システムHomebrewの使い方 | Macとかの雑記帳](http://tukaikta.blog135.fc2.com/blog-entry-183.html)





---

# その他開発関係ツール

### codekit

CodeKit automatically compiles Less, Sass, Stylus, CoffeeScript & Haml files.

* http://incident57.com/codekit/
* [H2O Blog., 新世代Web構築には必須になりそうな『CodeKit』](http://blog.h2o-space.com/post/12365214600)


### pandoc

書き溜めたmarkdownメモを
ドキュメントつくるときにpandoc使ってhtml化してる

* http://johnmacfarlane.net/pandoc/
* [Markdown/HTML/LaTexを相互変換「Pandoc」 - MOONGIFT](http://www.moongift.jp/2007/12/pandoc/)


### Integrity

高速リンクチェッカー。デプロイ前の必須アイテム

* http://peacockmedia.co.uk/integrity/
* [MacでWebサイトのリンク切れをチェックできるアプリケーション『Integrity』 | kotaログ](http://www.kotalog.net/archives/2566)


### Omnigraffle

シェア。ドキュメント作成ツール。これで仕様書を作るとめちゃくちゃ捗る。

### osx-gcc-installer

Macで「xcodeは要らないけど、gccだけ欲しいわー」ってなったときに死ぬほど有り難いツール。とりあえずWatchかブクマ。

* https://github.com/kennethreitz/osx-gcc-installer

### VMware + Gentoo (or Ubuntu, Debian, etc)

### ImageOptim

画像ファイルを軽量化


### HTMLサーバとしてのDropbox
HTML+CSS+JSをグローバルアクセスからデバッグしようと思ったら、結局DropboxのPublicフォルダが一番簡単なことに気がつきました（スマフォ向けサイトとかね）。


---

# その他作業効率化関係ツール


### Caffeine

* http://lightheadsw.com/caffeine/
* [Mac OSXのスリープ防止に「Caffeine」 - MOONGIFT](http://moongift.jp/2007/10/caffeine/)


### BetterTouchTool

* http://blog.boastr.net/
* [Macのトラックパッド操作を快適にするBetterTouchToolの設定 - #RyoAnnaBlog](http://d.hatena.ne.jp/RyoAnna/20110731/1312100591)


### ClipMenu

* http://www.clipmenu.com/ja/
* [クリップボードを履歴管理する「ClipMenu」 - MOONGIFT](http://www.moongift.jp/2010/01/clipmenu/)


### Limechat for mac osx

Preferences -> Log -> Show image links in inlineを有効にすると
ユーザー名に対応した画像をTwitterから引っ張ってきてインラインで展開してくれる。
もちろん間違ってるプロフィール画像が展開されることもあるけど、有名人多いIRCとかだとだいたいあってる。

* http://limechat.net/mac/ja.html
* [軽くてシンプルなIRCクライアント『LimeChat』 | Macの手書き説明書](http://veadardiary.blog29.fc2.com/blog-entry-2672.html)


### QuickSilver

Quicksilverは、アプリケーションの立ち上げ、コンピューター・ファイルの操作、e-mailの下書きと送信といった作業を、キーボードにより、手早く処理できる。

* http://www.blacktree.com/
* http://ja.wikipedia.org/wiki/Quicksilver


### Quix

quix便利やけど使ってる人見たことない

* http://www.quixapp.com/
* [ライフハッカーお勧めの多機能ブックマークレットQuixを試したら本当に便利だった - かちびと. net](http://kachibito.net/web-service/quix.html)

### Skitch

* http://skitch.com/jp/
* [Macのキャプチャ・編集ソフト「Skitch」が大変便利 - カイ士伝](http://bloggingfrom.tv/wp/2010/05/05/3668)


### Lingon

フリーorシェア。自動起動の管理ツール。OSXの自動起動プログラムを視覚的に編集したりできる。

* http://www.peterborgapps.com/lingon/
* [launchdの設定をGUIで編集「Lingon」 - MOONGIFT](http://www.moongift.jp/2008/04/lingon/)


### Growl

基本的なところでMacだとGrowl


### Alfred

QuickSilverみたいなfuzzyな文字列による、アプリケーション検索 & 実行ランチャ。QuickSilverよりも良いのは、マッチするアプリケーションがなかったときはGoogleで検索してくれること。

### Reeder

RSSリーダーは Reeder がおすすめ。

* http://reederapp.com/mac/

### Cinch

Macで簡単に画面2分割（Win7のあれ）をやってくれるツール。同僚に教えてもらってアディクトしてしまった。

* http://www.irradiatedsoftware.com/cinch/

### Fluid

Webアプリを簡単にローカルアプリ化出来るヤツ。Webアプリで簡単に開発して、クライアントをブラウザにしなくなかったり、常駐させたいときに便利。


### DIVVY

画面をショートカットキー1発で分割できる


### A Better Finder Rename

バッチリネームが超絶簡単

### Skim

軽量PDFリーダ。Adobe Acrobatよりも気持ちいい


### Bean

Microsoft Wordよりも快適


---

# Unix/Linux/Macコマンド

* gdb
* lv
* xargs
* iotop
* htop
* iperf
* htop
* zsh
* tree
* make
* bison
* awk


------

* screen
* byobu
* tmux

> これはサーバで長時間かかる作業を不安定な回線などで行うときに特に役立ちます。

　
> screenは手軽にプロセスを長生きさせるのに便利です。
sshで接続して何かしらの時間がかかるプロセスを実行しても、接続切ったらプロセスもカーネルに殺されてしまう。
そこでscreenの中でプロセスを起動して、screenをデタッチしとくと、そのプロセスを生き長らえさせることができます。

　
> 最初にありがたいと思ったのはサーバー上で長い事作業する時
通信がぶちっと切れてもscreenのプロセス自体は生き残るので、再度サーバーに接続して
残ってるscreenのプロセスにアタッチすれば作業が即再開できる。
vimの作業状態なんかもそのまま残っている
byobuというのはscreenがいい感じにカスタマイズされた奴

　
> screenは最近tmuxに置き換えました。まだ使いこなしてないけど。

　
> screen/tmux がとっつきにくいという向けにはbyobu がお勧めです．
とりあえず困らない設定になっています．
>
後は以下に沢山のtips が
"ターミナルマルチプレクサ Advent Calendar 2011 : ATND" http://atnd.org/events/22320

　
> ネイティブのバイナリ関連なら、od,file,nm,strings,strace,varglind

　
> あと個人的にはvim/zsh/screen。この3つはどんな環境でも必ず入れる

　
> find ./ -name *.php | xargs grep hoge とかはよく使いますね。Windowsは秀丸のgrepが強力です。




### git, よく使うコマンドとオプション, コマンド小ネタ, シェル小ネタ

http://qiita.com/items/2047#comment-2182

### 寒い日にCPUが発熱してあったかくなるコマンド

寒い日は充電中のMacBook上で```ruby -r digest/sha1 -e 'loop{Digest::SHA1.hexdigest(Time.now.to_f.to_s)}'```
とかしてしばらく放置すると勝手にCPUが発熱してあったかくなる

---

# ウェブサービス


### Qiita

ここ

* http://qiita.com/


# 未分類

### mscgen

シーケンス図を書くのであればmscgenをお勧めします。
日本語もフォントを指定すれば問題なくうごきます。

* http://www.mcternan.me.uk/mscgen/

### cheat

* https://github.com/defunkt/cheat

### yUML

UMLを描いて出力できるWebサービスです。ユニークなURLが発行されるのでブログに貼り付けたり出来ます

クラス図 / アクティビティ図 / ユースケース図

* http://yuml.me/

### WebSequenceDiagrams.com

UMLを描いて出力できるWebサービスです。ユニークなURLが発行されるのでブログに貼り付けたり出来ます

シーケンス図

http://www.websequencediagrams.com/

### Cacoo

### AppleK for VMware

Macで仮想マシン上のWindowsを使う場合にキー操作がMacと同じになるように設定してくれるアプリ。有料だけどVM上での作業効率が大きく上がるのでおすすめ。

- VMWare用
http://www.trinityworks.co.jp/software/AppleKforVMware3/index.php
- Parallels用
http://www.trinityworks.co.jp/software/AppleKforParallels3/index.php

### KeyRemap4Macbook

なぜかまだ挙げられていないKeyRemap4Macbook。キー割り当てを自在にカスタマイズできる他、キーリピートやキーウェイトを標準仕様より高速化できる。Mac使いのプログラマにとっては定番のアプリ
http://pqrs.org/macosx/keyremap4macbook/index.html.ja

### BitNami

様々なOSSプラットフォーム/アプリをインストーラを使って簡単に導入し試すことの出来るソフト
http://bitnami.org/stacks


### AMPPS

様々なOSSプラットフォーム/アプリをインストーラを使って簡単に導入し試すことの出来るソフト
http://www.ampps.com/

### TEKICO

日本語・欧文のダミーテキストを生成するAIR製ソフト。Webサイトのプロトタイプ作成時に活躍。

* http://www.uniteair.co.jp/app/air/pid_001.html



------

作業メモ
2012/02/08
http://qiita.com/items/2047#comment-2159 まで書き写した

2012/02/09
http://qiita.com/items/2047#comment-2215 まで書き写した
\#comment-2219 まで取り込んだ
Googleとかでタイトルの後ろがtruncateされて本家と区別つかないのでタイトル変更「これ知らないプログラマって損してんなって思う汎用的なツール 100超 まとめ」→「【まとめ】これ知らないプログラマって損してんなって思う汎用的なツール 100超」

2012/02/10
http://qiita.com/items/2047#comment-2295 まで書き写した
未分類だったものをある程度分類した

英語コミットコメントに使えそうなオシャレフレーズを聞いたので、これを使ってドヤ顔コミットをしたくてやれるチャンスを虎視眈々と狙う毎日です :shipit:

v, x, g, z とかこのへんが入ってる単語だとなんかカッコ良さ増す。
tweak とかデザイナーにはだいぶ便利。

|単語|意味|
----|----
|undesirable|好ましくない|
|avoid, circumvent|回避する|
|retrieve| 取りに行く(fetch / 「受け取る」よりもっと能動的に「取りに行く」ニュアンスを示す)|
|revise|= fix|
|tweak|微調整する|
|in the sight of 〜| 〜の視点で (point of view をわざと仰々しく言った感じ)|
|refer|参照する|
|disambiguate|曖昧さをなくす|
|quite|とても（veryのかわりにつかえる|
|literally|文字通り|
|exactly|まさに、確かに、イグザクトリー|
|resurrect|よみがえらせる|
|in favor of|〜に賛成して, 何かに沿って|
|get rid of|好ましくないものを取り除く|
|kick out| get rid of の強いバージョン、腹立たしさある|
|introduce|導入する|
|extract|抽出する|
|no longer used|もはや使われてない|
|R.I.P.|安らかに眠れ（もう使ってないコードを消す時などに。「Removeでは語りきれない思いがあるんだ」 by @idesaku ）|
|defeat|倒す、打ち負かす|
|:put_litter_in_its_place:```:put_litter_in_its_place:```|ゴミはゴミ箱へ（不要なコメントやwhitespaceを消したときなど）|
|cosmetic change, cosme|インデントを美しくした時など|
|fruitful|みのりの多い〜, fruitful discussion など|
|:golf:```:golf:```|コードをより短くした（code golf）|
|Take a cup of coffee|JS を CoffeeScript 化した, またはCoffeeをよりCoffeeらしく書いた|
|kick in|効きはじめる, 適用される など（DHHが使っていたらしい。）|
|A in B out|Bの変わりにAを導入（サッカー的な感じ。Gemの差し替えなどに使う）|
|enable to work|動くようにした|
|wipe out|拭い去る（get rid of, kick out の亜種）|
|stop rendering 〜|〜を表示しない|
|aesthetic|cosmetic の亜種（多分）|
|Ooops! :scream: |しょうもないミスした時などに。 :scream_cat: ```:scream_cat:``` 使うとかわいみでる。|

随時追加しています :baby_chick:
あと、ぷるりくとかもお待ちしてます :bird:

### あわせて読みたい
コミットコメントに対する心得がわかりやすく書いてありました。当記事の補完としてお読みいただけるとイイカンジ。
[初心者から一歩抜け出すためのGitの業 Vol.3](http://qiita.com/tbaba/items/77224ad2046c918d061b)

## はじめに: 遠回りせずに「近道」を探す

RubyやRailsを始めたばかりの人は、もっと短く書く方法や便利な標準ライブラリの存在を知らずに遠回りした書き方をしてしまいがちです。

そこで、RubyやRails初心者の人によく見かける「遠回り(または車輪の再発明)」と、それを回避する「近道」をいろいろ集めてみました。

### 2013.11.06 追記
この投稿を書くに至った経緯などを自分のブログに書きました。
こちらも合わせてどうぞ！

- [昨日Qiitaに投稿した記事は普段のコードレビューの副産物 - give IT a try](http://blog.jnito.com/entry/2013/11/06/072831)

## Ruby編

以下はRubyの標準機能を使ったイディオムやメソッドです。
Railsプロジェクトでもそれ以外でも使えます。(Ruby 1.9以上を想定)

### 後置ifで行数を減らす

````ruby
if user.active?
send_mail_to(user)
end
````

````ruby
send_mail_to(user) if user.active?
````

### if + notではなく、unlessを使う

````ruby
user.destroy if !user.active?
````

````ruby
user.destroy unless user.active?
````

ただし、unlessの条件がandやorでつながっていたり、否定形の条件が入っていたりすると、読み手の脳に負担がかかるので、複雑な条件はifを使う方が良いです。

````ruby
# こんなunlessは理解するのに時間がかかるのでNG
user.destroy unless (user.active? || user.admin?) && !user.spam?
````

### 三項演算子を使って行数を減らす

````ruby
if user.admin?
"I appreciate for that."
else
"Thanks."
end
````

````ruby
user.admin? ? "I appreciate for that." : "Thanks"
````

ただし、三項演算子をネストさせたりすると極めて読みにくくなるのでやめておきましょう。

````ruby
# 三項演算子のネストは読みづらい
user.admin? ? user.active? ? "I appreciate for that." : "Are you OK?" : "Thanks."
````

### 代入してからifで存在を確認、をまとめて書く

````ruby
user = find_user
if user
send_mail_to(user)
end
````

````ruby
if user = find_user
send_mail_to(user)
end
````

ただし、このイディオムは「`==`と`=`を書き間違えたんじゃないか？」と読み手に勘違いされる恐れもあるので、好き嫌いが分かれるのも事実です。

### 子どものオブジェクトが存在する場合にのみ、そのプロパティやメソッドを呼び出して条件を確認する、をひとつのifで書く

以下のコードは、`parent.children`が`nil`になっている可能性があるので、`children`が存在するときだけ`children.singleton?`を呼び出したい、というようなケースです。

````ruby
if parent.children
if parent.children.singleton?
singleton = parent.children.first
send_mail_to(singleton)
end
end
````

````ruby
if parent.children && parent.children.singleton?
singleton = parent.children.first
send_mail_to(singleton)
end
````

Ruby 2.3では safe navigation operator という新しい演算子（`&.`）が追加されました。
これを使うと `nil` かもしれないオブジェクトにメソッド呼び出しを試すことができます。
もしオブジェクトが `nil` であれば戻り値も `nil` になります。

````ruby
# Ruby 2.3以降（childrenがnilでもエラーにならず、nilが返る）
if parent.children&.singleton?
singleton = parent.children.first
send_mail_to(singleton)
end
````

その他、Ruby 2.3の新機能についてはこちらの記事をご覧ください。

[サンプルコードでわかる！Ruby 2.3の主な新機能 - Qiita](http://qiita.com/jnchito/items/0faac073cb77417d61c7)

### メソッドの戻り値を返すときにreturnを使わない

他の言語からやってきた人はついつい`return`を使いたくなりますが、`return`を使わない書き方の方がRubyっぽいです。

````ruby
def build_message(user)
message = 'hello'
message += '!!' if user.admin?
return message
end
````

````ruby
def build_message(user)
message = 'hello'
message += '!!' if user.admin?
message
end
````

### 「初期化、プロパティセット、戻り値として返す」の代わりにObject#tapを使う

tapを使わなくても行数は同じですが、ローカル変数の宣言や値を返却するためだけに書く最後の行がいらなくなります。

````ruby
def build_user
user = User.new
user.email = "hoge@hoge.com"
user.name = "Taro Yamada"
user
end
````

````ruby
def build_user
User.new.tap do |user|
user.email = "hoge@hoge.com"
user.name = "Taro Yamada"
end
end
````

### "+”ではなく"#{ }"で文字列を連結する

````ruby
"Hello, " + user.name + "!"
````

````ruby
"Hello, #{user.name}!"
````

### 複数行にわたる文字列はヒアドキュメントを使う

```rb
text = "Hello, world!\nGood-bye, world!"
```

```rb
text = <<-TEXT
Hello, world!
Good-bye, world!
TEXT
```

Rubyのヒアドキュメントは高機能なので、もっと詳しく知りたい方は公式ドキュメントやネット上の情報を参考にしてください。

[ヒアドキュメント (行指向文字列リテラル)](http://docs.ruby-lang.org/ja/2.3.0/doc/spec=2fliteral.html#here)

### 定数はfreezeさせる

文字列であれ、配列であれ、ハッシュであれ、定数宣言した値は`freeze`しておく方が無難です。万一変更されると困るので。

#### 文字列の場合

````ruby
CONTACT_PHONE_NUMBER = "03-1234-5678"
CONTACT_PHONE_NUMBER << "@#$%^"
puts CONTACT_PHONE_NUMBER # => 03-1234-5678@#$%^
````

````ruby
CONTACT_PHONE_NUMBER = "03-1234-5678".freeze
CONTACT_PHONE_NUMBER << "@#$%^" # => RuntimeError: can't modify frozen String
````

#### 配列の場合

````ruby
ADMIN_NAMES = ["Tom", "Alice"]
ADMIN_NAMES << "Taro"
ADMIN_NAMES[0].downcase!
puts ADMIN_NAMES # => ["tom", "Alice"]
````

````ruby
ADMIN_NAMES = ["Tom", "Alice"].freeze.each(&:freeze)
ADMIN_NAMES << "Taro" # => RuntimeError: can't modify frozen Array
ADMIN_NAMES[0].downcase! # => RuntimeError: can't modify frozen String
````

#### 整数の場合

整数(`FixNum`)は変更不能なので`freeze`しなくても問題ありません。

````ruby
# エラーにはならないが、あまり意味が無い
ITEM_LIMIT = 500.freeze
````

### 配列やハッシュを初期化する際、最後の要素をあえてカンマ付きで書いておく

配列やハッシュを初期化する場合は、カンマで要素を区切ります。

```rb
countries = [
:japan,
:italy,
:uk
]

capitals = {
japan: 'Tokyo',
italy: 'Rome',
uk: 'London'
}
```

Rubyでは次のように、最後の要素にカンマを付けても文法上エラーになりません。

```rb
countries = [
:japan,
:italy,
:uk,
]

capitals = {
japan: 'Tokyo',
italy: 'Rome',
uk: 'London',
}
```

将来的に要素が追加される可能性が高い配列やハッシュであれば、1つ前の行を修正せずに新しい要素を追加できるので、プログラム修正の手間が少し省けます。

```rb
countries = [
:japan,
:italy,
:uk,
:india, # <= 1つ前の行を修正せずに追加
]

capitals = {
japan: 'Tokyo',
italy: 'Rome',
uk: 'London',
india: 'New Delhi', # <= 1つ前の行を修正せずに追加
}
```

また、すべての要素にカンマを付けておけば、要素の順番を入れ替えたいときも行単位の単純なカット＆ペーストで修正できますね。

### 配列を作るとき、[ ]の代わりに%w( )、%i( )を使う

文字列だけの配列を作りたい場合は`%w( )`を使うと少し短く書けます。

````ruby
actions = ['index', 'new', 'create']
````

````ruby
actions = %w(index new create) # => ['index', 'new', 'create']
````

Ruby 2.0なら`%i( )`でシンボルの配列も作れます。

````ruby
actions = %i(index new create) # => [:index, :new, :create]
````

### 配列を順番に処理するとき、"object.method"の代わりに"&:method"を使う

````ruby
names = users.map{|user| user.name }
````

````ruby
names = users.map(&:name)
````

`map`に限らず、`each`や`select`などブロックで配列の中身を受け取るようなメソッドは同じように`&:method`で処理できます。

### nilか配列かを区別せず、Array( )で処理してしまう

基本的に配列だが、nilが渡される場合もある変数を処理する場合、`Array()`（`Kernel#Array`）を使うと条件分岐を無くせます。

```rb
# usersはnilが渡される場合もあるので分岐する
if users
users.each{|user| send_direct_mail(user) }
end
```

```rb
# Array()を使うと、nilの場合は空の配列（[])が、それ以外は元の配列が返されるので分岐が不要
Array(users).each{|user| send_direct_mail(user) }
```


### 大きな数値を宣言する場合、"_"を入れて読みやすくする

````ruby
ITEM_LIMIT = 1000000000
````

````ruby
ITEM_LIMIT = 1_000_000_000
````

### 単純なgetterメソッドを定義する代わりに、attr_readerを使う

````ruby
class Person
def initialize
@name = "No name"
end

def name
@name
end
end
````

````ruby
class Person
attr_reader :name

def initialize
@name = "No name"
end

# いらない
# def name
# @name
# end
end
````

### 要素の順番に意味がある配列は、同時に別々の変数で受け取る

`変数 = 配列`のように書くと変数には配列が格納されますが、`変数, 変数 = 配列`のように書くと配列の各要素を別々の変数に格納できます。

````ruby
ans_array = 14.divmod(3)
puts "商は#{ans_array[0]}" # => 商は4
puts "あまりは#{ans_array[1]}" # => あまりは2
````

````ruby
quotient, remainder = 14.divmod(3)
puts "商は#{quotient}" # => 商は4
puts "あまりは#{remainder}" # => あまりは2
````

ハッシュを`each`で回したときに、ブロックが受け取る引数も同じですね。

````ruby
# keyとvalueを配列として受け取る
{name: 'Tom', email: 'hoge@hoge.com'}.each do |key_and_value|
puts "key: #{key_and_value[0]}"
puts "value: #{key_and_value[1]}"
end
````

````ruby
# keyとvalueを別々の変数で受け取る
{name: 'Tom', email: 'hoge@hoge.com'}.each do |key, value|
puts "key: #{key}"
puts "value: #{value}"
end
````

### 配列を連結するのに+ではなく、*(splat)を使う

````ruby
numbers = [1, 2, 3]
numbers_with_zero_and_100 = [0] + numbers + [100] # => [0, 1, 2, 3, 100]
````

````ruby
numbers = [1, 2, 3]
numbers_with_zero_and_100 = [0, *numbers, 100] # => [0, 1, 2, 3, 100]
````

ちなみに`*`がないと、こうなります。(配列が展開されない)

````ruby
[0, numbers, 100] # => [0, [1, 2, 3], 100]
````

### nilだったら初期化、の代わりに ||= を使う

いわゆる遅延初期化のイディオムですね。

````ruby
def twitter_client
@twitter_client = Twitter::REST::Client.new if @twitter_client.nil?
@twitter_client
end
````

````ruby
def twitter_client
@twitter_client ||= Twitter::REST::Client.new
end
````

初期化の処理が複数行にわたる場合は`begin/end`を使うことができます。（[参考](http://blog.honeybadger.io/rubyist_guide_to_memoization/)）

````ruby
def twitter_client
return @twitter_client if @twitter_client
@twitter_client = Twitter::REST::Client.new
# 初期化に必要な処理
# ...
@twitter_client
end
````

````ruby
def twitter_client
@twitter_client ||= begin
client = Twitter::REST::Client.new
# 初期化に必要な処理
# ...
client
end
end
````


### ハッシュのキーには文字列ではなくシンボルを使う

ハッシュに値をセットする場合、キーには文字列よりもシンボルを使う方がベターです。

```rb
# キーに文字列を使う
currencies = { 'japan' => 'yen', 'america' => 'dollar', 'italy' => 'euro' }
currencies['japan'] # => 'yen'
```

```rb
# キーにシンボルを使う
currencies = { japan: 'yen', america: 'dollar', italy: 'euro' }
currencies[:japan] # => 'yen'
```

シンボルを使うと以下のようなメリットがあります。

- `{ key: value }` のように簡潔なリテラルで書ける。
- 文字列よりも速い。
- 文字列よりもメモリの使用効率が良い。

参考： [Why use symbols as hash keys in Ruby? - Stack Overflow](http://stackoverflow.com/questions/8189416/why-use-symbols-as-hash-keys-in-ruby)

### メソッド全体rescueの対象にするときはbegin/endを省く

````ruby
def process_user(user)
begin
send_to_mail(user)
rescue
# 例外処理
end
end
````

````ruby
def process_user(user)
send_to_mail(user)
rescue
# 例外処理
end
````

### Exceptionをrescueするのではなく、StandardErrorをrescueする

JavaやC#をやっていた人は「すべての例外を捕捉したい = Exceptionを捕捉する」と考えがちです。
しかし、Rubyで`Exception`を捕捉すると、`NoMemoryError`等の致命的な例外も捕捉してしまいます。


実行時エラーを表すRubyの例外クラスは`Exception`のサブクラスである`StandardError`です。
rescueでデフォルトで捕捉するのは`StandardError`とそのサブクラスなので、すべての実行時エラーを捕捉したい場合は`rescue`節に具体的な例外クラス名を書く必要はありません。

````ruby
def process_user(user)
send_to_mail(user)
rescue Exception => ex
# NoMemoryError等の致命的な例外まで捕捉してしまうので良くない
end
````

````ruby
def process_user(user)
send_to_mail(user)
rescue => ex
# すべての実行時エラー(＝ StandardErrorとそのサブクラス)が捕捉される
end
````

- 参考: http://qiita.com/jnchito/items/a6046733dd5683ff35b7

### 一度rescueした例外をもう一度再raiseする

「ある特定の例外クラス」だけでなく、「例外メッセージの中身」も確認して条件に合致すればrescue、そうでなければ対象外のエラーなのでそのままシステムエラーにしたい、というケースがたまにあります。

その場合はrescue節の中で`raise`を呼ぶと元のエラーを再raiseできます。

````ruby
def process_user(user)
send_to_mail(user)
rescue ArgumentError => ex
if ex.message =~ /blah blah blah/
# ArgumentErrorかつ、メッセージも条件に合致すれば
# 別の処理を実行してそのまま続行する
send_to_admin(user, ex)
else
# メッセージが条件に合致しなかった場合は対処不能なエラーとして
# 元のエラーを再度raiseする
raise
end
end
````

### private 以下の行にクラスメソッドを定義して、privateなクラスメソッドを作ったと勘違いしない

以下のようにprivateの下にインスタンスメソッドとクラスメソッドを定義したとします。

```rb
class User
private

def secret_name
# 外部から呼ばれたくないインスタンスメソッド
"secret!"
end

def self.secret_data
# 外部から呼ばれたくないクラスメソッド！？
"secret!!"
end
end
```

上のコードを実行すると、`secret_name`は呼び出せませんが、`self.secret_data`呼び出すことが可能です。

```rb
user = User.new

# 呼び出せない
user.secret_name
# => NoMethodError: private method `secret_name' called for #<User:0x007fa90c1e7cd0>

# 呼び出せる
User.secret_data
# => "secret!!"
```

以下のように`private_class_method`を付けると、外部から呼び出せなくなります。

```rb
class User
private

def secret_name
# 外部から呼ばれたくないインスタンスメソッド
"secret!"
end

def self.secret_data
# 外部から呼ばれたくないクラスメソッド
"secret!!"
end

# secret_dataをprivateなクラスメソッドにする
private_class_method :secret_data
end
```

```rb
User.secret_data
# => NoMethodError: private method `secret_data' called for User:Class
```

ですが、privateなインスタンスメソッドを作るときに比べると手間がかかるので、「どうしても」という場合以外は「クラスメソッドはpublicのままにしておく」という選択肢もアリかもしれません。
（そもそもクラスメソッドを多用しすぎている場合は、クラス設計に何か問題がある可能性が高いです）

参考： [クラスメソッドのprivate化 - @tmtms のメモ](http://tmtms.hatenablog.com/entry/20100629/ruby_private_class_method)


### privateメソッドはそのクラスでしか呼び出せない、と勘違いしない

以下のようにprivateなインスタンスメソッド（`secret_price`）を定義したとします。

```rb
class Item
private

def secret_price
1000
end
end
```

さらに、上の`Item`クラスを継承したクラスを定義します。この中で`secret_price`メソッドを呼び出すようにします。

```rb
class Book < Item
def public_price
secret_price
end
end
```

すると、`Book`クラスのインスタンスから問題なく（`public_price`メソッド経由で）`secret_price`メソッドを呼び出すことができます。

```rb
book = Book.new
book.public_price
# => 1000
```

Javaや.NETの経験が長いと、privateメソッドはそのクラスでしか呼び出せないと思ってしまいがちですが、Rubyでは継承先でprivateメソッドが呼ばれる可能性があります。
そのクラスの中で呼び出されていないからといって安易にprivateメソッドを削除すると、継承先のクラスで呼び出されたときにエラーが発生するかもしれないので気をつけてください。

参考：[JavaやC#の常識が通用しないRubyのprivateメソッド - give IT a try](http://blog.jnito.com/entry/20120315/1331754912)

### size - 1ではなく、マイナスのインデックスで最後の文字や要素を指定する

````ruby
numbers = [1, 2, 3, 4, 5]
name = 'Taro Yamada'

numbers[numbers.size - 1] # => 5
name[name.size - 1] # => 'a'

numbers[1..numbers.size - 2] # => [2, 3, 4]
name[1..name.size - 2] # => "aro Yamad"
````

````ruby
numbers = [1, 2, 3, 4, 5]
name = 'Taro Yamada'

numbers[-1] # => 5
name[-1] # => 'a'

numbers[1..-2] # => [2, 3, 4]
name[1..-2] # => "aro Yamad"
````

### 配列の便利なメソッドいろいろ

#### find: 最初に見つかったものを返す

````ruby
def find_admin(users)
users.each do |user|
return user if user.admin?
end
nil
end
````

````ruby
def find_admin(users)
users.find(&:admin?)
end
````

最初の見つかった要素のインデックスを返す場合は`find_index`。

#### select: 条件に合うものすべてを返す

````ruby
def find_admins(users)
admins = []
users.each do |user|
admins << user if user.admin?
end
admins
end
````

````ruby
def find_admins(users)
users.select(&:admin?)
end
````

`select`とは反対で`false`になる要素だけを集める場合は`reject`。

#### count: 条件に合う要素の数を返す

````ruby
def count_admin(users)
count = 0
users.each do |user|
count += 1 if user.admin?
end
count
end
````

````ruby
def count_admin(users)
users.count(&:admin?)
end
````

#### map: ある配列から別の配列を作る

````ruby
def user_names(users)
names = []
users.each do |user|
names << user.name
end
names
end
````

````ruby
def user_names(users)
users.map(&:name)
end
````

#### flat_map: mapの結果をネストしないフラットな配列として受け取る

```ruby
nested_array = [[1, 2, 3], [4, 5, 6]]
mapped_array = nested_array.map {|array| array.map {|n| n * 10 } }
# => [[10, 20, 30], [40, 50, 60]]
flat_array = mapped_array.flatten
# => [10, 20, 30, 40, 50, 60]
```

```ruby
nested_array = [[1, 2, 3], [4, 5, 6]]
flat_array = nested_array.flat_map {|array| array.map {|n| n * 10 } }
# => [10, 20, 30, 40, 50, 60]
```



#### compact: nil以外の要素を集める

````ruby
numbmers_and_nil = [1, 2, 3, nil, nil, 6]
only_numbers = numbmers_and_nil.reject(&:nil?) # => [1, 2, 3, 6]
````

````ruby
numbers_and_nil = [1, 2, 3, nil, nil, 6]
only_numbers = numbers_and_nil.compact # => [1, 2, 3, 6]
````

#### any?: 最低でも1つ条件に合う要素があればtrueを返す

````ruby
def contains_nil?(users)
users.each do |user|
return true if user.nil?
end
false
end
````

````ruby
def contains_nil?(users)
users.any?(&:nil?)
end
````

すべての要素が条件に合っている場合に`true`を返す場合は`all?`。

#### empty?: 1件もなければtrueを返す

````ruby
puts "empty!" if users.size == 0
````

````ruby
puts "empty!" if users.empty?
````

#### first/last: 最初と最後の要素を返す

````ruby
first_user = users[0]
last_user = users[users.size - 1]
````

````ruby
first_user = users.first
last_user = users.last
````
#### sample: 任意の要素を返す

````ruby
users[rand(users.size)]
````

````ruby
users.sample
````

#### each_with_index: eachでループしつつ、カウンタも同時に取得する

````ruby
counter = 0
users.each do |user|
puts ", " if counter > 0
puts user.name
counter += 1
end
````

````ruby
users.each_with_index |user, counter|
puts ", " if counter > 0
puts user.name
end
````

#### ループ処理系のメソッド + with_index: カウンタ付きで元のループ処理を実行する

````ruby
counter = 1
users_with_index = users.map do |user|
[counter, user]
counter += 1
end
````

````ruby
users_with_index = users.map.with_index do |user, counter|
[counter + 1, user]
end
````

`with_index`はカウンタの初期値を指定できます。（デフォルトはゼロ）
なので、上のコードは次のように書いても同じです。

````ruby
users_with_index = users.map.with_index(1) do |user, counter|
[counter, user]
end
````



#### join: 配列を1つの文字列として返す

````ruby
def numbers_text(numbers)
text = ''
numbers.each_with_index do |number, i|
text += ', ' if i > 0
text += number.to_s
end
text
end
````

````ruby
def numbers_text(numbers)
numbers.join(', ') # [1, 2, 3] => "1, 2, 3"
end
````

#### max/max_by: 最大の要素を返す

````ruby
def oldest_user(users)
oldest = nil
users.each do |user|
oldest = user if oldest.nil? || user.age > oldest.age
end
oldet
end
````

````ruby
def oldest_user(users)
users.max_by(&:age)
end
````

単純な数値や文字列の配列なら`numbers.max`だけでもOK。
最小の要素を返す場合は`min`や`min_by`を使う。

#### each_with_object: ループを回しつつ、別のオブジェクトを組み立ててそれを返す

````ruby
def admin_names(users)
ret = []
users.each do |user|
ret << user.name if user.admin?
end
ret
end
````

````ruby
def admin_names(users)
users.each_with_object([]) do |user, names|
names << user.name if user.admin?
end
end
````

まあ、上のサンプルのような場合は`users.select(&:admin?).map(&:name)`って書けばいいんですけどね。

#### その他の情報源

全部挙げていくとキリがないので、配列を操作するロジックを書く前にまず、`Array`や`Enumerable`のAPIドキュメントを読んで「車輪の再発明」をしていないかチェックしてください。

- http://ruby-doc.org/core-2.0.0/Array.html
- http://ruby-doc.org/core-2.0.0/Enumerable.html

### 英語の文法や品詞を意識する

ケースバイケースで原則から外れる場合は十分ありえますが、文法や品詞の使いわけに明らかな逸脱(間違い)があると読み手が混乱します。

#### 配列の変数名や配列を返すメソッド名は原則複数形にする

````ruby
# number = [1, 2, 3]
numbers = [1, 2, 3]
````

````ruby
# def find_even_number(numbers)
# numbers.select(&:even?)
# end

def find_even_numbers(numbers)
numbers.select(&:even?)
end
````

#### プロパティや変数名、クラス名は原則名詞や形容詞に、何かを操作するメソッドは原則動詞にする


````ruby
# reserve=予約する(動詞)、reserved=予約済みである(形容詞)

# chair.reserve?
chair.reserved? # => false

# chair.reserved('Tom')
chair.reserve('Tom')

chair.reserved? # => true
````

その他、英語の使い方については以下の記事も参考になると思うので、あわせて読んでみてください。

[モデルやメソッドに名前を付けるときは英語の品詞に気をつけよう](http://qiita.com/jnchito/items/459d58ba652bf4763820)

## Rails編

以下はRails開発時にのみ使えるイディオムやメソッドです。
標準のRubyでは用意されていないので使えません。

ただし、大半のメソッドはActiveSupportのGemを導入することで使えるようになります。

````
$ gem install active_support
````

````ruby
require 'active_support/all'

nil.blank? # => true
````



### nilチェックの代わりにObject#try(:method_name)を使う



````ruby
if parent.children && parent.children.singleton?
singleton = parent.children.first
send_mail_to(singleton)
end
````

````ruby
# childrenがnilならtry(:singleton?)はnilを返す
# nilでなければ、children.singleton?が普通に呼ばれる
if parent.children.try(:singleton?)
singleton = parent.children.first
send_mail_to(singleton)
end
````

### 「nil、もしくは空っぽい値」のチェックにblank?/present?を使う

````ruby
# String
name = nil
name.blank? # => true
name = ""
name.blank? # => true
name = " "
name.blank? # => true
name = "Tom"
name.blank? # => false

# Array
numbers = nil
numbers.blank? # => true
numbers = []
numbers.blank? # => true
numbers = [1, 2, 3]
numbers.blank? # => false

# Hash
params = nil
params.blank? # => true
params = {}
params.blank? # => true
params = { name: "Tom", email: "hoge@hoge.com" }
params.blank? # => false
````

`present?`は`blank?`の反対で、「空ではない値」のときに`true`を返します。

````ruby
# String
name = ""
name.present? # => false
name = "Tom"
name.present? # => true
````

### 「空なら別の値を代入」の代わりにpresenceを使う

````ruby
if user.name.blank?
name = "What's your name?"
else
name = user.name
end
````

````ruby
name = user.name.presence || "What's your name?"
````

`"".presence`や`[].presence`は`nil`を返すので注意してください。(`blank?`かどうかを判別しているため)

````ruby
name = ""
puts name.presence || "What's your name?" # => What's your name?
````

**2014.11.12 追記**
`presence` を使うと便利なイディオムがありました。

````ruby
# Newsが1件でも存在すればメール送信＆ツイート発信
good_news = company.good_news
if good_news.count > 0
send_mail(good_news)
tweet(good_news)
end
````

上のようなコードはpresenceを使うと一行で代入と条件判断ができます。

````ruby
if good_news = company.good_news.presence
send_mail(good_news)
tweet(good_news)
end
````

`company.good_news.presence` は `company.good_news` が0件だと `nil` が返るので `false` 扱いになり、if文の中が実行されません。

同様に、「文字列に何かしらの値が入っている場合」を分岐させるケースでも役立ちます。

```ruby
# nameがnilや空文字列（""）だったらメッセージを表示したくない
name = blog.user.name
if name.present?
show_message("Hello, #{name}!")
end
```

```ruby
if name = blog.user.name.presence
show_message("Hello, #{name}!")
end
```

### 存在の有無を確認する場合はblank?/present?を積極的に使う

Rubyの標準APIでは`nil?`や`empty?`のように「無い」を表すメソッドしかないので、「もしあるなら」をコードで表現するとぎこちなくなります。

````ruby
if user
# userがいれば、何かを実行する
# =>「もしuserがいれば」ではなく「もしuserなら」と読めてしまう
end

unless users.empty?
# usersが空ではないなら、何かを実行する
# => empty?の逆がないので、否定形で条件を書かざるを得ない
end
````

Railsであれば、`present?`を使って「もしあれば」を明示的に書くことができます。

````ruby
if user.present?
# userがいれば、何かを実行する
# =>「もしuserがいれば」と明示的に読める
end

if users.present?
# usersに1つ以上の要素があれば、何かを実行する
# => 肯定形で条件が書ける
end
````

### 文字列の存在チェックはnil?ではなく、blank?を積極的に使う

「文字列に値が入っていない」状態は`nil`と`""`の区別をしないことが多いと思います。
(`nil`は空白だが`""`は空白ではない、とわざわざ区別することはほとんどないはず)

`nil?`を使うと`""`は入力済みであるというような条件文を書いてしまう恐れがあります。
なのでRailsでは`nil?`の代わりに`blank?`を使う癖を付けておく方が良いです。

````ruby
if email.nil?
# => emailが "" なら入力済みとして扱われてしまい、コールされない
puts "Please input email!"
end
````

````ruby
if email.blank?
# => emailが "" や " " の場合でも未入力と扱われるので、コールされる
puts "Please input email!"
end
````

同じ理由でModelの`validates`で指定するオプションも、特別な理由が無い限り`allow_nil: true`ではなく、`allow_blank: true`を使うようにしましょう。

- 参考: http://edgeguides.rubyonrails.org/active_record_validations.html#common-validation-options


### ロジックではなく、クエリでフィルタリングする

Ruby編で配列の便利なメソッドをいろいろ紹介しましたが、RailsのModelをフィルタリングしたい場合は配列を操作するのではなく、データベース(SQL)上でフィルタリングした方が効率的です。

````ruby
def admin_users
User.all.select(&:admin?)
end
````

````ruby
def admin_users
User.where(admin: true)
end
````


### mapではなく、pluckを使う

`pluck`を使うと必要なカラムだけをデータベースから取得するので処理効率が良くなります。

````ruby
def admin_user_ids
User.where(admin: true).map(&:id)
end
````

````ruby
def admin_user_ids
User.where(admin: true).pluck(:id)
end
````

### tap の代わりに new + ブロックを使う

ActiveRecordであれば `new` に直接ブロックを渡して、プロパティをセットすることができます。
（ @sachin21 さん、コメントありがとうございます！ ）

```rb
def build_user
User.new.tap do |user|
user.email = "hoge@hoge.com"
user.name = "Taro Yamada"
end
end
```

```rb
def build_user
User.new do |user|
user.email = "hoge@hoge.com"
user.name = "Taro Yamada"
end
end
```

### Railsにおけるタイムゾーンの扱いを理解する

Railsの場合、application.rbに設定したタイムゾーンが使われる場合と、環境変数 TZ に設定されたタイムゾーンが使われる場合の2パターンがあります。
両者のタイムゾーン設定が異なる場合、予期せぬ不具合が生まれる恐れがあります。

そうした不具合を防ぐため、コード内ではapplication.rbに設定されたタイムゾーンを使うように統一することが望ましいです。
具体的には、`Date.today`ではなく`Date.current`を、`Time.now`ではなく`Time.current`（または`Time.zone.now`）を使うようにしてください。

詳しい内容はこちらの記事にまとめてあるので読んでみてください。

[RubyとRailsにおけるTime, Date, DateTime, TimeWithZoneの違い](http://qiita.com/jnchito/items/cae89ee43c30f5d6fa2c)


### 日付や日時の便利メソッドを活用する

#### システム日付から見た昨日/明日を求める

````ruby
Date.current # => Tue, 05 Nov 2013

Date.yesterday # => Tue, 04 Nov 2013
Date.tomorrow # => # => Tue, 06 Nov 2013
````

#### システム日時から見たxx年前/後、xxヶ月前/後、xx週間前/後、xx日前/後、etcを求める

````ruby
Date.current # => 2013-11-05

2.years.ago # => 2011-11-05 06:21:40 +0900
2.years.since # => 2015-11-05 06:21:40 +0900

2.months.ago # => 2013-09-05 06:21:40 +0900
2.months.since # => 2014-01-05 06:21:40 +0900
````

weeks, days, hours, minutes, secondsでも同じように使えます。

#### 特定の日付/日時から見た昨日/明日、先週/来週、xx日前/後、etcを求める

結果を求める方法は一つだけでなく、いろいろな書き方があります。

````ruby
date = Date.current # => 2013-11-05

date.yesterday # => 2013-11-04
date.tomoroow # => 2013-11-06

date.prev_day # => 2013-11-04
date.next_day # => 2013-11-06

date.prev_day(2) # => 2013-11-03
date.next_day(2) # => 2013-11-07

date - 2.days # => 2013-11-03
date + 2.days # => 2013-11-07

date.ago(2.days) # => 2013-11-03
date.since(2.days) # => 2013-11-07

date.prev_month # => 2013-10-05
date.next_month # => 2013-12-05

date.prev_month(2) # => 2013-09-05
date.next_month(2) # => 2014-01-05

date - 2.months # => 2013-09-05
date + 2.months # => 2014-01-05

date.months_ago(2) # => 2013-09-05
date.months_since(2) # => 2014-01-05

date.ago(2.months) # => 2013-09-05
date.since(2.months) # => 2014-01-05
````

week, year等でも考え方は同じです。
Time型でも使えます。

#### ある日付/日時から見た始まりと終わりの日付/日時を求める

````ruby
date = Date.current # => 2013-11-05

date.beginning_of_month # => 2013-11-01
date.end_of_month # => 2013-11-30

date.beginning_of_day # => 2013-11-05 00:00:00 +0900
date.end_of_day # => 2013-11-05 23:59:59 +0900

datetime = Time.current # => 2013-11-05T06:43:53+09:00

datetime.beginning_of_hour # => 2013-11-05T06:00:00+09:00
datetime.end_of_hour # => 2013-11-05T06:59:59+09:00
````

week, year等でも考え方は同じです。
Time型でも使えます。

#### 1日の初めから終わりまで、月の初めから終わりまで、といった範囲を求める

`all_xxx` メソッドを使うと、「xxxの始めから終わりまで」をRangeオブジェクトとして取得できます。

```rb
time = Time.current
# => Mon, 23 Nov 2015 16:45:23 JST +09:00

# その日の始まりと終わりの日時を取得
time.all_day
# => Mon, 23 Nov 2015 00:00:00 JST +09:00..Mon, 23 Nov 2015 23:59:59 JST +09:00

# その日から見た月の始まりと、月の終わりの日時を取得する
time.all_month
# => Sun, 01 Nov 2015 00:00:00 JST +09:00..Mon, 30 Nov 2015 23:59:59 JST +09:00

# その日から見た年の始まりと、年の終わりの日時を取得する
time.all_year
# => Thu, 01 Jan 2015 00:00:00 JST +09:00..Thu, 31 Dec 2015 23:59:59 JST +09:00
```

他にも`all_week`や`all_quarter `といったメソッドが定義されています。

#### ある日付から見た先週/来週のxx曜日を求める

````ruby
date = Date.current # => 2013-11-05
date.tuesday? # => true

date.prev_week(:monday) # => 2013-10-28
date.next_week(:monday) # => 2013-11-11
````

他の曜日でも考え方は同じです。

#### その他の情報源

日付、日時の操作例を挙げ始めるとキリがないので、詳しくはActiveSupportのAPIを参照してください。

- http://guides.rubyonrails.org/active_support_core_extensions.html

### 語形やフォーマットを変える (2013.11.14追記)

````ruby
# キャメルケースにする
"my_book".camelize # => "MyBook"

# アンダースコア区切り(スネークケース)にする
"MyBook".underscore # => "my_book"

# ダッシュ(ハイフン)区切りにする
"my_book".dasherize # => "my-book"

# 複数形にする
"book".pluralize # => "books"
"person".pluralize # => "people"
"fish".pluralize # => "fish"
"book_and_person".pluralize # => "book_and_people"
"book and person".pluralize # => "book and people"
"BookAndPerson".pluralize # => "BookAndPeople"

# 単数形にする
"books".singularize # => "book"
"people".singularize # => "person"
"books_and_people".singularize # => "books_and_person"
"books and people".singularize # => "books and person"
"BooksAndPeople".singularize # => "BooksAndPerson"

# 人間が読みやすくする(一文字目は大文字 + スペース区切り)
"my_books".humanize # => "My books"

# タイトル形式にする(各単語の一文字目が大文字 + スペース区切り)
"my_books".titleize # => "My Books"

# クラス名にする(キャメルケース + 単数形)
"my_book".classify # => "MyBook"
"my_books".classify # => "MyBook"

# テーブル名にする(アンダースコア区切り + 複数形)
"my_book".tableize # => "my_books"
"MyBook".tableize # => "my_books"
````

#### その他の情報源

`constantize`や`demodulize`など、個人的に使用頻度が低そうだなと思ったメソッドは紹介しませんでした。
他のメソッドも気になる方はRailsのAPIドキュメントを参照して下さい。

- http://apidock.com/rails/String

### 余分なスペースや改行を取り除く (2013.11.14追記)

````ruby
" My \r\n \t \n books ".squish # => "My books"
````

## まとめ: 良いコードを書くために

### 魚ではなく、「魚の釣り方」を覚える

「遠回り」や「車輪の再発明」をする前に、もっと良い書き方はないか、すでに同じメソッドが用意されていないか、書籍やAPIドキュメントをしっかり読みましょう。

- [プログラミング言語 Ruby](http://goo.gl/ItJeDc) - オライリージャパン
- [Rails3レシピブック 190の技](http://goo.gl/iu1Tc4) - ソフトバンククリエイティブ
- [ruby-doc.org](http://ruby-doc.org)
- [String](http://ruby-doc.org/core-2.0.0/String.html)
- [Array](http://ruby-doc.org/core-2.0.0/Array.html)
- [Hash](http://ruby-doc.org/core-2.0.0/Hash.html)
- [Enumerable](http://ruby-doc.org/core-2.0.0/Enumerable.html)
- [RailsGuides](http://guides.rubyonrails.org/)
- [Active Support Core Extensions](http://guides.rubyonrails.org/active_support_core_extensions.html)
- [Active Record Query Interface](http://guides.rubyonrails.org/active_record_querying.html)

### チーム内でコードレビューをする

書籍やAPIドキュメントだけでなく、同僚の知見も有効な情報源です。
チーム内で定期的にコードレビューを行い、お互いの知見を交換しあいましょう。

また、コードの短さや簡潔さに凝りすぎると、独りよがりでわかりにくいコードを書いてしまう恐れもあるため、コードレビューを通じてチーム内で「わかりやすいコード」「わかりにくいコード」の判断基準を共有しておくことも重要です。

## おまけ: トリビア的なテクニック

こういう書き方もあるけど無理して使わなくても良いかも、と思うような記法も紹介しておきます。

### 「1文字」を表すのに「?+文字」を使う

````ruby
"index,new,create".split(',') # => ["index", "new", "create"]
````

````ruby
"index,new,create".split(?,) # => ["index", "new", "create"]
````

タイプ量は減りますが、直感的なわかりやすさに関しては微妙かも・・・。

### 配列を順番に処理するとき、直接メソッドを呼ぶ代わりに"&method(:name)"を使う

普通にブロックを書く方が一般的ですが、`&method(:name)`みたいな引数を渡すこともできます。

````ruby
def process_users
users.each do |user|
process_user(user)
end
end

def process_user(user)
send_mail_to(user)
user.mail_sent_at = Time.now
user.save
end
````

````ruby
def process_users
users.each(&method(:process_user))
end

def process_user(user)
send_mail_to(user)
user.mail_sent_at = Time.now
user.save
end
````

### 配列を順番に処理するとき、ブロックを直接書く代わりにlambdaを使う

複雑な条件式とかをlambdaにして明示的な名前を付けておくと多少読みやすくなるかも、です。

````ruby
def destroy_aged_admins(users, limit_age)
users.select{|user| user.admin? && user.age > limit_age }.each(&:destroy)
end
````

````ruby
def destroy_aged_admins(users, limit_age)
aged_admin = ->(user){ user.admin? && user.age > limit_age }

users.select(&aged_admin).each(&:destroy)
end
````

でも上のサンプルだとこう書いた方がわかりやすいかな。。。

````ruby
def destroy_aged_admins(users, limit_age)
aged_admins = users.select{|user| user.admin? && user.age > limit_age }
aged_admins.each(&:destroy)
end
````

### 何が何でもtrueかfalseで条件分岐させたいとき、!!を使う

Rubyでは`false`と`nil`が`false`、それ以外の値がすべて`true`と評価されます。
JavaやC#を長くやっていたので最初は僕も違和感がありましたが、使っているうちにこれはこれで良くできてるなと感じてきました。

しかし、世の中には「わしゃtrueかfalseで条件分岐させなきゃイヤなんぢゃ！！」というプログラマもいるかもしれません。
そんな人は「イヤなんぢゃ！！」の`!!`を値の前に付ければ、Rubyが必ず`true`か`false`を返してくれます。

````ruby
!!nil # => false
!!false # => false
!!0 # => true
!![] # => true
!!true # => true
````

実は`BasicObject`クラスには`!`というメソッドが用意されているので、こんな書き方もできます。

```rb
nil.!.! # => false
false.!.! # => false
0.!.! # => true
[].!.! # => true
true.!.! # => true
```

このメソッドを使えば、`nil?`や`empty?`の逆も作れます。

```rb
puts "User exists!" if user.nil?.!
puts "Some users exist!" if users.empty?.!
```

・・・が、何もそこまでがんばる必要はないんじゃないかと僕は思います ^^;

#課題

サイトをを立ち上げるときに当然のごとくSSL証明書をベンダーから購入して設置していたが、いざセキュリティ診断等でチェックしてもらうとSSLについての指摘を何件か受けてみた。なんでだろうと思いながらも、さらに最適なSSL設定は？と聞かれてそういえばあまり昔から手を入れたことなかったなと思い調べてみた

#SSL通信が確立するまでの概要フロー

SSL通信について再度おさらい



#Nginxを元にしたSSLの設定

nginxの[HTTPS サーバの設定](http://nginx.org/ja/docs/http/configuring_https_servers.html)を参考に、たった２行だけどSSLを考えてみる。書き方は違えどもapacheも概念は一緒のはず。

```Nginx
ssl_protocols SSLv3 TLSv1;
ssl_ciphers HIGH:!ADH:!MD5;
```

#SSLプロトコルの種類を確認

[wiki](http://ja.wikipedia.org/wiki/Transport_Layer_Security)よりプロトコルの種類を確認してみる。

|略称|正式名称|開発元|
|---|---|---|
|SSL|Secure Socket Layer|ネットスケープコミュニケーション|
|TLS|Transport Layer Security|IETF|

バージョン毎の概要を確認してみる。

|バージョン|安全性|概要|
|---|:---:|---|
|SSL1.0|✕|最初のSSLとして設計したが、設計レビューの時点でプロトコルの脆弱性が発見されたため破棄されている。|
|[SSL2.0](https://tools.ietf.org/html/rfc6176)|✕|SSL1.0の問題を修正して設計後、1994年にSSL2.0として発表。その後、いくつか脆弱性が発見されてSSL3.0が登場するが、未使用でもSSL2.0が有効な状態の場合に提示する最弱のアルゴリズムを使用させるダウングレード攻撃などを受ける可能性があるので、明示的に無効にする必要がある。|
|[SSL3.0](https://tools.ietf.org/html/rfc7568)|✕|SSL2.0の問題を修正して機能追加も行い1995年にSSL3.0として発表。ただ、古くなってきている。CVE-2014-3566で脆弱性が発生したため明示的に無効にする必要がある。|
|[TLS1.0](https://tools.ietf.org/html/rfc2246)|△|SSL3.0とTLS1.0の両者間には正確な互換性はないがほぼ同じ。CVE-2011-3389(BEAST)による一部脆弱性を含む。|
|[TLS1.1](https://tools.ietf.org/html/rfc4346)|◯|TLS 1.0からの変更点は、新しく発見された攻撃手法に対する耐性の強化が中心である。|
|[TLS1.2](https://tools.ietf.org/html/rfc5246)|◎|ハッシュのアルゴリズムにSHA-256が追加されたほか、ブロック暗号について、従来のCBCモードだけではなく、GCM、CCMといった認証付き暗号が利用可能となった。|
|[TLS1.3](https://tlswg.github.io/tls13-spec/)|?|[ドラフト]インターネット環境の変化とTLS1.2までの暗号化強度不足を改善するため2016年中に仕様化完了を目指している(らしい)|

そのため、SSLv1 / SSLv2 / SSLv3 は脆弱性があるので、 **現時点で使用できるものはTLSv1以上**

#SSL_Ciphersについて調べてみる...

`HIGH:!ADH:!MD5;`と書いてはあるものの、「HIGHグループでADHとMD5を使わない」という読み方であってるのか？調べてみると[OpenSSL](https://www.openssl.org/docs/apps/ciphers.html)で確認出来るらしい

`$ openssl ciphers -v 'HIGH:!ADH:!MD5;'`


```bash:result
DHE-RSA-AES256-SHA SSLv3 Kx=DH Au=RSA Enc=AES(256) Mac=SHA1
DHE-DSS-AES256-SHA SSLv3 Kx=DH Au=DSS Enc=AES(256) Mac=SHA1
DHE-RSA-CAMELLIA256-SHA SSLv3 Kx=DH Au=RSA Enc=Camellia(256) Mac=SHA1
DHE-DSS-CAMELLIA256-SHA SSLv3 Kx=DH Au=DSS Enc=Camellia(256) Mac=SHA1
AES256-SHA SSLv3 Kx=RSA Au=RSA Enc=AES(256) Mac=SHA1
CAMELLIA256-SHA SSLv3 Kx=RSA Au=RSA Enc=Camellia(256) Mac=SHA1
PSK-AES256-CBC-SHA SSLv3 Kx=PSK Au=PSK Enc=AES(256) Mac=SHA1
EDH-RSA-DES-CBC3-SHA SSLv3 Kx=DH Au=RSA Enc=3DES(168) Mac=SHA1
EDH-DSS-DES-CBC3-SHA SSLv3 Kx=DH Au=DSS Enc=3DES(168) Mac=SHA1
DES-CBC3-SHA SSLv3 Kx=RSA Au=RSA Enc=3DES(168) Mac=SHA1
PSK-3DES-EDE-CBC-SHA SSLv3 Kx=PSK Au=PSK Enc=3DES(168) Mac=SHA1
KRB5-DES-CBC3-SHA SSLv3 Kx=KRB5 Au=KRB5 Enc=3DES(168) Mac=SHA1
DHE-RSA-AES128-SHA SSLv3 Kx=DH Au=RSA Enc=AES(128) Mac=SHA1
DHE-DSS-AES128-SHA SSLv3 Kx=DH Au=DSS Enc=AES(128) Mac=SHA1
DHE-RSA-CAMELLIA128-SHA SSLv3 Kx=DH Au=RSA Enc=Camellia(128) Mac=SHA1
DHE-DSS-CAMELLIA128-SHA SSLv3 Kx=DH Au=DSS Enc=Camellia(128) Mac=SHA1
AES128-SHA SSLv3 Kx=RSA Au=RSA Enc=AES(128) Mac=SHA1
CAMELLIA128-SHA SSLv3 Kx=RSA Au=RSA Enc=Camellia(128) Mac=SHA1
PSK-AES128-CBC-SHA SSLv3 Kx=PSK Au=PSK Enc=AES(128) Mac=SHA1
```

なんかいっぱい出てきた

#暗号方法の内容を１つ１つ確認

まずは１行目の `DHE-RSA-AES256-SHA　　 SSLv3 　Kx=DH　 Au=RSA　 Enc=AES(256)　 Mac=SHA1` を読み解いてみる。[このサイト](http://nzbget.net/Choosing_a_cipher)によると下記のようだ。

|Column|内容|原文|
|---|---|---|
|DHE-RSA-AES256-SHA|暗号化スイート|cipher suite name|
|kx|鍵交換をする時のアルゴリズム|the algorithm used for key exchange|
|Au|鍵認証のためのアルゴリズム|the algorithm for authentication|
|Enc|暗号化通信に使われる一括暗号化アルゴリズム|the bulk encryption algorithm|
|Mac|メッセージ認証符号|the message authentication code (MAC) algorithm|

いろいろアルゴリズムを使ってるのはわかったもののどこで使ってるんだ？

#それぞれどこで使ってるの？

#主な暗号化アルゴリズム

種類がたくさんありますが、一部集めてみました。

|アルゴリズム|用途|ブロック長|鍵長|概要|
|---|---|---|---|---|
|[RSA](http://ja.wikipedia.org/wiki/RSA%E6%9A%97%E5%8F%B7)|Au:公開鍵暗号[署名]||1024-4096 bit|[主流] 桁数が大きい合成数の素因数分解問題が困難であることを安全性の根拠とした公開鍵暗号の一つである|
|[DSA](http://ja.wikipedia.org/wiki/Digital_Signature_Algorithm)|Au:公開鍵暗号[署名]||1024bit|[まだ少ない?] OpensslでみるとDSSと表記されている。有限体上の離散対数問題の困難性を安全性の根拠としており、現仕様においては有効な攻撃方法が示されたことはないものの、理論上はいまだ署名としての最も高い安全性を満たすことが証明されていない。|
|[ECC](http://ja.wikipedia.org/wiki/%E6%A5%95%E5%86%86%E6%9B%B2%E7%B7%9A%E6%9A%97%E5%8F%B7)|Au:公開鍵暗号[署名]|||[注目株] EC-DLPを解く準指数関数時間アルゴリズムがまだ見つかっていないため、それが見つかるまでの間は、[ベリサイン](http://www.atmarkit.co.jp/ait/articles/1303/21/news005.html)によると12分の1の鍵長で、現在主流のRSA 2048の1.5倍の強度を実現できるため同レベルの安全性をより短い鍵で実現でき、処理速度も速いことをメリットとして、ポストRSA暗号として注目されている。|
|[DH](https://www.ipa.go.jp/security/rfc/RFC2631JA.html)|Kx:公開鍵暗号[鍵交換]|||[主流] DHパラメータは証明書に書かれている物を使う。よって、static DHとも呼ばれる。|
|[ECDH](http://en.wikipedia.org/wiki/Diffie-Hellman_key_exchange)|Kx:公開鍵暗号[鍵交換]|||[注目株] Elliptic curve Diffie–Hellmanの略。楕円曲線上でDiffie-Hellman(DH)鍵共有を⾏う楕円DH(ECDH)⽅式。PFS(perfect forward secrecy)をサポートしていない。 |
|[ECDSA](http://en.wikipedia.org/wiki/Elliptic_Curve_DSA)|Kx:公開鍵暗号[鍵交換]|||[注目株] Elliptic Curve Digital Signature Algorithmの略。楕円曲線上でDigital Signature Algorithm(DSA)を実現する楕円DSA（ECDSA）⽅式。PFS(perfect forward secrecy)をサポートしていない。|
|[ECDHE](http://vincent.bernat.im/en/blog/2011-ssl-perfect-forward-secrecy.html)|Kx:公開鍵暗号[鍵交換]|||[注目株] Ephemeral Elliptic curve Diffie–Hellmanの略。DHパラメータを通信時に動的に作成する。楕円曲線上でDiffie-Hellman(DH)鍵共有を⾏う楕円DH(ECDH)⽅式。EはEphemeral(一時的）を意味している。PFS(perfect forward secrecy)をサポートしている。 |
|[DES](http://en.wikipedia.org/wiki/Data_Encryption_Standard)|Enc:共通鍵暗号|64bit|56bit|[強度弱] 現代においては十分な強度とは言えなくなっています。並列処理可能なDES破り専用プロセッサも存在し、 資金さえ投入すれば数時間～数日というレベルで解読することができます。|
|[AES](http://en.wikipedia.org/wiki/Advanced_Encryption_Standard)|Enc:共通鍵暗号|128bit|128/192/256bit|[注目株] DESに代わる次世代の暗号標準。暗号強度、高速性に優れてます。|
|[RC4](http://en.wikipedia.org/wiki/RC4)|Enc:共通鍵暗号|可変長|ストリーム暗号|[脆弱性あり] RC4はストリーム暗号としては大変広く使われていますが、同時にいろんな脆弱性があることでも知られてきている。WEPやSSL/TLSで広く使われてますが、WEPが脆弱であることが広く知られているのに比べ、SSL/TLSでのRC4はそれほど恐れられていませんでした。|
|[MD5](http://en.wikipedia.org/wiki/MD5)|Mac:ハッシュ関数|||[脆弱性あり] 任意長メッセージから128ビットの一方向ハッシュ値を生成します。SLOTH攻撃(CVE-2015-7575)による影響があります。|
|[SHA-1](http://ja.wikipedia.org/wiki/SHA-1)|Mac:ハッシュ関数|||[脆弱性あり] 160ビットメッセージダイジェストアルゴリズム。SLOTH攻撃(CVE-2015-7575)による影響があります。|
|[SHA-2](https://jp.globalsign.com/sha256/)|Mac:ハッシュ関数|||[主流] 224ビット・256ビット・384ビット・512ビットのメッセージダイジェストアルゴリズム|
|[SHA-3](https://ja.wikipedia.org/wiki/SHA-3)|Mac:ハッシュ関数|||[次世代?]米国の国立標準技術研究所(NIST)は，2012年10月2日に次世代の暗号学的ハッシュ関数の標準を決めるSHA-3として Keccak を選定した。しかし、その後、SHA-2への有望な攻撃法は2015年8月現在発表されていないため結果としてSHA-2の代替の用意が重要ではなくなるなど、状況が変化している|


#暗号化利用モード

[暗号化利用モード](http://en.wikipedia.org/wiki/Block_cipher_modes_of_operation)とは、ブロック長よりも長いメッセージを暗号化するための方式。

|略称|名称|利用モード|概要|
|---|---|---|---|
|ECB|Electronic CodeBook|秘匿用|[強度弱]各ブロックを１つずつ暗号化処理をする。最もシンプルな方式
|[CBC](http://j-net21.smrj.go.jp/develop/digital/entry/001-20120229-01.html)|Cipher Block Chaining|秘匿用|[脆弱性あり]各平文のブロックは暗号化される前に、前の暗号化ブロックでXORすることを繰り返す。最初のブロックは暗号と無関係なIV(Initialization Vector)を使用して暗号化する。BEAST攻撃によりデータが復号化される可能性あり。
|CTR|CounTeR|秘匿用|[主流]IVではなくカウンターの値をインクリメントしつつブロック暗号処理したものに平文ブロックをXORする。|
|[CCM](http://en.wikipedia.org/wiki/CCM_mode)|Counter with CBC-MAC|認証用|TLS1.2で使用可能。カウンター (CTR)モードとCBC-MACモードを組み合わせたものであり、前者が暗号化に、後者が認証に用いられる。同一の鍵を暗号化と認証の双方に用いることができることができ、暗号化に用いられたカウンター値が認証で用いられる初期化ベクトルと衝突することがない|
|[GCM](http://en.wikipedia.org/wiki/Galois/Counter_Mode)|Galois/Counter Mode|認証用|[主流]TLS1.2で使用可能。GCMは認証付き暗号の一つであり、データ保護と認証（完全性確認）の双方に利用できる。遅延、オーバーヘッドが少ないことから、パケット化されたデータの保護に適している。|

#PFS(Perfect Forward Secrecy)について

[SSL/TLS & Perfect Forward Secrecy](http://vincent.bernat.im/en/blog/2011-ssl-perfect-forward-secrecy.html)

|名称|略称|概要|Kx|例|
|---|---|---|---|---|
|Without forward secrecy|-|認証と同じ公開暗号を使用した場合に、攻撃者が暗号化した通信を全部記録していたとすると、後に認証に使用していた秘密鍵が漏洩してしまうと復号化が出来てしまう。|FS・PFS以外|AES128-SHA|
|Forward Secrecy|FS|認証用の鍵と鍵交換用の鍵が異なるので、通信の漏洩の可能性が低くなります。RSA 2048bitと比べるとサーバへのCPU負荷が3.1倍程度に増加するようです。|DH / ECDH|DH-RSA-AES128-SHA|
|Perfect Forward Secrecy|PFS|FSに比べて、一定時間後に定期的に異なる鍵交換を行うため、より漏洩の可能性を低く出来ます。また、RSA 2048bitと比べてもサーバへのCPU負荷は微増のようです。|DHE / ECDHE|DHE-RSA-AES128-SHA|


#暗号化方法はたくさんあるけどナニを選べばいいの？

[SSL/TLS Deployment Best Practices](https://www.ssllabs.com/projects/best-practices/index.html) というのがある


> Use Secure Protocols
>
> * SSL v2 is insecure and must not be used.
>
> * SSL v3 is very old and obsolete. Because it lacks some key features and because virtually all clients support TLS 1.0 and better, you should not support SSL v3 unless you have a very good reason.
>
> * TLS v1.0 is largely still secure; we do not know of major security flaws when they are used for protocols other than HTTP. When used with HTTP, it can almost be made secure with careful configuration.
> * TLS v1.1 and v1.2 are without known security issues.

***SSLプロトコル***

* SSLv2は使用しない
* SSLv3は非常に古く廃止されています。いくつかの主要機能が不足しており、事実上すべてのクライアントがTLS1.0をサポートしている。そのため、よっぽど良い理由がない限りはSSLv3をサポートするべきではない
* TLS v1.0の大部分はまだ安全です。HTTPを使用するときに、キチンと設定をすればセキュアに出来る
* TLS v1.1 とTLS v1.2はセキュリティに関する問題が発見されていない

> Use Secure Cipher Suites
>
> * Anonymous Diffie-Hellman (ADH) suites do not provide authentication.
>
> * NULL cipher suites provide no encryption.
>
> * Export key exchange suites use authentication that can easily be broken.
>
> * Suites with weak ciphers (typically of 40 and 56 bits) use encryption that can easily be broken.
>
> * RC4 is weaker than previously thought. You should remove support for this cipher in the near future.
>
> * 3DES provides only 108 bits of security (or 112, depending on the source), which is below the
recommended minimum of 128 bits. You should remove support for this cipher in the near future.

***暗号化スイート***

* ADH(Anonymous Diffie-Hellman)は認証機能を提供していない
* Null暗号化スイートは暗号化しない
* Export鍵交換は簡単に解除される認証機能を使っている
* 特に40, 56bitの弱い暗号スイートは簡単に暗号化を解除される
* RC4は以前考えられてたよりも弱い。近い将来、サポート対象外にするべき。
* 3DESは108または112bitsしか提供していない。最低でも128bits以上が推奨されるので、近い将来サポート対象外にするべき。

#セキュリティに余念のない有名企業はどうしているのか？

[Netcraft](http://news.netcraft.com/archives/2013/06/25/ssl-intercepted-today-decrypted-tomorrow.html)が2013年9月に調査した情報によると下記のような対応状況です。2014年3月にwww.facebook.comを確認したところ、ECDHE-RSA-AES128-GCM-SHAになっていたので各社変わっている可能性はありそうです。


#最近発生した主なSSLの脆弱性

|名称|CVE|発生日|概要|対応概要|
|---|---|---|---|---|
|[Beast](http://blog.zoller.lu/2011/09/beast-summary-tls-cbc-countermeasures.html)|[CVE-2011-3389](http://web.nvd.nist.gov/view/vuln/detail?vulnId=CVE-2011-3389)|2011/9/6|CBC mode脆弱性||
|[TLS heartbleed](http://d.hatena.ne.jp/Kango/20140410/1397139257)|[CVE-2014-0160](https://www.openssl.org/news/secadv_20140407.txt)|2014/4/7|TLS脆弱性|opensslをupdate|
|[CCS injection](http://d.hatena.ne.jp/Kango/touch/20140605/1401978480)|[CVE-2014-0224](https://www.openssl.org/news/secadv_20140605.txt)|2014/6/5|CCS脆弱性|opensslをupdate|
|[POODLE](http://googleonlinesecurity.blogspot.jp/2014/10/this-poodle-bites-exploiting-ssl-30.html)|[CVE-2014-3566](https://access.redhat.com/security/cve/CVE-2014-3566)|2014/10/14|SSLv3脆弱性|SSLv3を無効にする|
|[複数脆弱性](https://jvn.jp/vu/JVNVU95877131/index.html)|[CVE-2015-0291等(全14個)](https://www.openssl.org/news/secadv_20150319.txt)|2015/3/19|複数脆弱性対応|opensslをupdate|
|[Altチェイン証明書偽造](http://d.hatena.ne.jp/jovi0608/20150710/1436521488)|[CVE-2015-1793](https://mta.openssl.org/pipermail/openssl-announce/2015-July/000037.html)|2015/7/6|証明書偽造|opensslをupdate|
|[SLOTH攻撃](http://d.hatena.ne.jp/jovi0608/20160113/1452649563)|[CVE-2015-7575](https://access.redhat.com/articles/2112261)|2016/1/8|TLS脆弱性(ハッシュ衝突)|[MD5とSHA-1を使用しない](https://nakedsecurity.sophos.com/2016/01/08/the-sloth-attacks-why-laziness-about-cryptography-puts-security-at-risk/)|
|[DROWN](http://d.hatena.ne.jp/Kango/20160301/1456849603)|[CVE-2016-0800](https://mta.openssl.org/pipermail/openssl-announce/2016-March/000066.html)|2016/3/1|クロスプロトコル攻撃|SSLv2を無効にする|
|[SWEET32](https://sweet32.info/)|[CVE-2016-2183](https://access.redhat.com/security/cve/cve-2016-2183)|2016/8/24|[誕生日攻撃](https://ja.wikipedia.org/wiki/%E8%AA%95%E7%94%9F%E6%97%A5%E6%94%BB%E6%92%83)|3DESなど64bitsブロック暗号の停止|
|[SHAttered](https://security.googleblog.com/2017/02/announcing-first-sha1-collision.html)|[CVE-2005-4900](https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2005-4900)|2017/2/23|[ハッシュ衝突攻撃](https://shattered.io/)|SHA-256, SHA-3への移行|

#結局今のところどのような設定が良さそうか

最初に記載したNginxの公式にサイトに書いてあったよりも、脆弱性があるまたは弱い暗号化を除いて、明示的に使用する暗号化スイートを設定するのが良さそう。 ***あくまで例なのでサイトに合ったものを設定してください。***

* 最新版のopenssl [CVE-2014-0160 / CVE-2014-0224]
* 128bit以上
* Enc: AES
* Au: RSA
* Kx: DH/ECDH/ECDHE (FS以上)
* 暗号化利用モード: GCM
* SSLv3以下を無効 [CVE-2014-3566]

```Nginx
ssl on;
ssl_prefer_server_ciphers on;
ssl_protocols TLSv1 TLSv1.1 TLSv1.2;
ssl_ciphers ECDHE+RSAGCM:ECDH+AESGCM:
DH+AESGCM:ECDH+AES256:DH+AES256:
ECDH+AES128:DH+AES:
!EXPORT:!DES:!3DES:!MD5:!DSS;
```

###対応暗号スイートを確認

```
$openssl ciphers -v 'ECDHE+RSAGCM:ECDH+AESGCM:DH+AESGCM:ECDH+AES256:DH+AES256:ECDH+AES128:DH+AES:!EXPORT:!DES:!3DES:!MD5:!DSS'
```

ローカルだとこのような感じで出てきた

```bash:result
ECDHE-RSA-AES256-GCM-SHA384 TLSv1.2 Kx=ECDH Au=RSA Enc=AESGCM(256) Mac=AEAD
ECDHE-ECDSA-AES256-GCM-SHA384 TLSv1.2 Kx=ECDH Au=ECDSA Enc=AESGCM(256) Mac=AEAD
ECDH-RSA-AES256-GCM-SHA384 TLSv1.2 Kx=ECDH/RSA Au=ECDH Enc=AESGCM(256) Mac=AEAD
ECDH-ECDSA-AES256-GCM-SHA384 TLSv1.2 Kx=ECDH/ECDSA Au=ECDH Enc=AESGCM(256) Mac=AEAD
ECDHE-RSA-AES128-GCM-SHA256 TLSv1.2 Kx=ECDH Au=RSA Enc=AESGCM(128) Mac=AEAD
ECDHE-ECDSA-AES128-GCM-SHA256 TLSv1.2 Kx=ECDH Au=ECDSA Enc=AESGCM(128) Mac=AEAD
ECDH-RSA-AES128-GCM-SHA256 TLSv1.2 Kx=ECDH/RSA Au=ECDH Enc=AESGCM(128) Mac=AEAD
ECDH-ECDSA-AES128-GCM-SHA256 TLSv1.2 Kx=ECDH/ECDSA Au=ECDH Enc=AESGCM(128) Mac=AEAD
DHE-RSA-AES256-GCM-SHA384 TLSv1.2 Kx=DH Au=RSA Enc=AESGCM(256) Mac=AEAD
DHE-RSA-AES128-GCM-SHA256 TLSv1.2 Kx=DH Au=RSA Enc=AESGCM(128) Mac=AEAD
ECDHE-RSA-AES256-SHA384 TLSv1.2 Kx=ECDH Au=RSA Enc=AES(256) Mac=SHA384
ECDHE-ECDSA-AES256-SHA384 TLSv1.2 Kx=ECDH Au=ECDSA Enc=AES(256) Mac=SHA384
ECDHE-RSA-AES256-SHA SSLv3 Kx=ECDH Au=RSA Enc=AES(256) Mac=SHA1
ECDHE-ECDSA-AES256-SHA SSLv3 Kx=ECDH Au=ECDSA Enc=AES(256) Mac=SHA1
ECDH-RSA-AES256-SHA384 TLSv1.2 Kx=ECDH/RSA Au=ECDH Enc=AES(256) Mac=SHA384
ECDH-ECDSA-AES256-SHA384 TLSv1.2 Kx=ECDH/ECDSA Au=ECDH Enc=AES(256) Mac=SHA384
ECDH-RSA-AES256-SHA SSLv3 Kx=ECDH/RSA Au=ECDH Enc=AES(256) Mac=SHA1
ECDH-ECDSA-AES256-SHA SSLv3 Kx=ECDH/ECDSA Au=ECDH Enc=AES(256) Mac=SHA1
DHE-RSA-AES256-SHA256 TLSv1.2 Kx=DH Au=RSA Enc=AES(256) Mac=SHA256
DHE-RSA-AES256-SHA SSLv3 Kx=DH Au=RSA Enc=AES(256) Mac=SHA1
ECDHE-RSA-AES128-SHA256 TLSv1.2 Kx=ECDH Au=RSA Enc=AES(128) Mac=SHA256
ECDHE-ECDSA-AES128-SHA256 TLSv1.2 Kx=ECDH Au=ECDSA Enc=AES(128) Mac=SHA256
ECDHE-RSA-AES128-SHA SSLv3 Kx=ECDH Au=RSA Enc=AES(128) Mac=SHA1
ECDHE-ECDSA-AES128-SHA SSLv3 Kx=ECDH Au=ECDSA Enc=AES(128) Mac=SHA1
ECDH-RSA-AES128-SHA256 TLSv1.2 Kx=ECDH/RSA Au=ECDH Enc=AES(128) Mac=SHA256
ECDH-ECDSA-AES128-SHA256 TLSv1.2 Kx=ECDH/ECDSA Au=ECDH Enc=AES(128) Mac=SHA256
ECDH-RSA-AES128-SHA SSLv3 Kx=ECDH/RSA Au=ECDH Enc=AES(128) Mac=SHA1
ECDH-ECDSA-AES128-SHA SSLv3 Kx=ECDH/ECDSA Au=ECDH Enc=AES(128) Mac=SHA1
DHE-RSA-AES128-SHA256 TLSv1.2 Kx=DH Au=RSA Enc=AES(128) Mac=SHA256
DHE-RSA-AES128-SHA SSLv3 Kx=DH Au=RSA Enc=AES(128) Mac=SHA1
```

Apacheの場合はこのような感じになると思う(Apache 2.4以降ではSSLv2が除外)

```Apache
SSLProtocol ALL -SSLv3
SSLHonorCipherOrder On
SSLCipherSuite ECDHE+RSAGCM:ECDH+AESGCM:
DH+AESGCM:ECDH+AES256:DH+AES256:
ECDH+AES128:DH+AES:
!EXPORT:!DES:!3DES:!MD5:!DSS
```

### 設定を生成してくれるサービスもある!

* [Mozilla SSL Configuration Generator](https://mozilla.github.io/server-side-tls/ssl-config-generator/)

#SSLがキチンと設定されているかテストするには

[SSL Server Test](https://www.ssllabs.com/ssltest/)または[GlobalSign SSL チェック](https://sslcheck.globalsign.com/ja)で暗号化強度やブラウザのサポート具合などもチェックできます。また、コンソールでチェックするのに[testssl.sh: Testing TLS/SSL encryption](https://testssl.sh/)も便利です。
簡易的には下記でもSSLの状態が確認出来る

```
$ openssl s_client -host [URL/HOST NAME] -port 443 -ssl3
```

#まとめ

たかが２行設定するのにここまで色々あるとは...まだ関連する技術がありそうなので日々精進が必要そうです。ただ、今回わかったことは単にコピペで設定すると、かなりのセキュリティホールになりそうなのでちゃんとテストして設定しようと。

#参考資料
> 電子政府における調達のために参照すべき暗号のリスト（ＣＲＹＰＴＲＥＣ暗号リスト）
http://www.cryptrec.go.jp/list.html
http://search.e-gov.go.jp/servlet/PcmFileDownload?seqNo=0000097652

> Hardening Your Web Server’s SSL Ciphers
https://hynek.me/articles/hardening-your-web-servers-ssl-ciphers/


> IE使うならVista以降が無難、SSLの暗号強度調査結果から
http://internet.watch.impress.co.jp/docs/event/iw2009/20091126_331592.html

> SSL/TLSでBEASTを恐れてRC4を優先するのは危ない
http://tetsutalow.hateblo.jp/entry/2013/04/02/053927

コメント／編集リクエスト歓迎します。載っていない語があればぜひ追加してください。

|略語|元の語|意味|
|---|---|---|
|AFAICT|As far as I can tell|分かる限りでは○○|
|AFAIK|As far as I know|知る限りでは○○|
|AKA, aka, a.k.a.|Also known as|○○としても知られる|
|ASAP|As soon as possible|できる限り早く|
|BTW|By the way|ところで|
|c.f., cf.|ラテン語 confer / 英語 compare|○○を参照|
|e.g., E.g.|ラテン語 exempli gratia / 英語 for example|たとえば|
|ETA|Estimated time of arrival|（作業の）完了予定時刻　（用例は[コメントを参照](http://qiita.com/items/86c3a09d17792ab62dfe#comment-54f3d7872ba953941e7d)）|
|FTW|For the win|〔何か良い案を挙げて〕これで決まり；これでよし|
|FWIW|For what it's worth|役に立つかどうかは分からないが|
|FYA|For your action|要対応；要返信|
|FYI|For your information|参考；ご参考までに|
|HTH|Happy to help|（用例は[コメントを参照](http://qiita.com/items/86c3a09d17792ab62dfe#comment-54f3d7872ba953941e7d)）|
|i.e., I.e.|ラテン語 id est / 英語 that is|すなわち|
|IIRC|If I remember [recall] correctly|記憶が正しければ○○|
|IIUC|If I understand correctly|〔相手の発言を受けて〕私の理解が正しければ|
|IMO, IMHO|In my (humble) opinion|〔ていねいに〕○○だと思います|
|LGTM|Looks good to me|〔提案に対して〕いいと思う；問題ないと思う；〔コードレビュアーが、問題ないコードに対して〕レビュー終了；（コードの）承認|
|LOL, lol|Laugh out loud| 〔くだけて〕www；（笑）|
|NA, N/A|Not applicable; not available|〔表などで、項目の組み合わせが無効な欄に記載して〕該当なし；〔表などで、まだ値がない欄に記載して〕該当値なし|
|NB, N.B.|ラテン語 nota bene / 英語 note well|〔通例コメントの先頭で〕特に注意せよ|
|NP, np|No problem|〔依頼・謝罪などに対してくだけて〕（問題ないから）気にしないで；大丈夫〔感謝に対してくだけて〕どういたしまして|
|OTOH|On the other hand|もう一方では、これに反して|
|PTAL|Please take another look|〔再レビューの要求などで〕再度ご確認ください|
|PR|Pull request|プルリクエスト|
|RFC|Request for comments|〔おもに issue のタグとして〕意見募集|
|ROFL, rofl|Rolling on the floor laughing|〔くだけて〕www；（笑）|
|RTFM|Read the fucking manual|〔乱暴に〕マニュアルを読め|
|TBA|To be advised|あとで連絡する|
|TBA|To be announced|あとで発表する|
|TBD|To be determined|あとで決める|
|TLDR, tldr, TL;DR, tl;dr, TL/DR, tl/dr|Too long, didn't read|長すぎるので読んでいない；（長い文を読みたくない人向けの）要約|
|UTSL|Use the source, Luke|〔くだけて〕ソースを読め（スター・ウォーズのセリフとかけた言葉遊び）|
|w/|with|（with の省略形）|
|w/o|without|（without の省略形）|
|WIP|Work in progress|作業中|
|WTF, wtf|What the fuck|〔想定外の事・ものにくだけて〕なんてこった；どうすりゃいいんだ；マジかよ|
|XD|顔文字：90度右に回すと、目をつぶって大きく口を開けた笑顔に見える|〔くだけたコメントで〕(≧▽≦)|

# おまけ

ソフトウェアのバージョン：

|略語|元の語|意味|
|---|---|---|
|GA|General availability|一般向け提供；正式リリース版|
|GM|Golden master|（CD プレスの）原盤；正式リリース版|
|RC|Release candidate|リリース候補版|
|RTM|Ready to manufacturing|量産可能；正式リリース版|

慣用表現：

|語|直訳|意味|
|---|---|---|
|Bikeshed, Bikeshedding|自転車置き場|重要でない議論に時間を取られること（家のペンキを塗り終える前に自転車置き場を何色で塗るか揉めることから）|
|Yak shaving|ヤクの毛刈り|ある大きな問題を解決するために、 一見無関係な小さい問題をいくつも片付けること。転じて、大きな問題を解決するつもりが、一見関係しているように見えて実は無用な小さい問題に気を取られること（長く固いヤクの毛を刈ってウールにするには多くの下準備が必要なことから）|

略語関連サイト：

- [Abbreviations.com - Computing Abbreviations](http://www.abbreviations.com/category/COMPUTING)
- [Acronym Finder](http://www.acronymfinder.com)

by @mixiappwchr



iOSでこんな感じアプリを作ろうと思うんだけど、こんなの作る場合何をみればいいの？というときの、
最初の一歩がわからない場合や、みんながはまりそうなポイントなどを中心に、皆さんのアプリ開発がこれでスタートダッシュ決めれれば幸いです。

Androidの方はこちらをどうぞ
[iOSとの比較つき!Androidでこんなアプリ,こんな機能を作りたかったらこれを見ろ！作りたいアプリに対応するクラス、ライブラリのまとめ！]
(http://qiita.com/appwatcher/items/7d270de99d63bb9f2be4)






#Twitter,Facebookみたいなタイムラインのアプリを作りたい！

まずは一番作りたいものとして思い浮かぶのがTwitterやFacebookみたいなタイムライン、フィードなどを閲覧するアプリでしょう。



##ここがポイント
iOS開発で一番使うと言っても過言でないUITableViewControllerの使い方でしょう。

###一行一行の高さを変えたいんだけれども？
(CGFloat)tableView:(UITableView *)tableView heightForRowAtIndexPath:(NSIndexPath *)indexPathを実装する

```objc:tableviewの高さを動的に
- (CGFloat)tableView:(UITableView *)tableView heightForRowAtIndexPath:(NSIndexPath *)indexPath {

return //高さを返す;
}
```

###セクションの見た目を思いっきり変えたいんだけれども？
- (UIView *)tableView:(UITableView *)tableView viewForHeaderInSection:(NSInteger)sectionで自由にカスタムしたUIViewを返すとokです。

```objc:tableviewの高さを動的に
- (UIView *)tableView:(UITableView *)tableView viewForHeaderInSection:(NSInteger)section
// コードで生成したり とかXib ,Storyboard内から生成とか
return //UIViewを返す;
}
```

###画像を表示しようとしたら遅いよ！
外部データを取ってきて表示するときにまずはまるのが画像の処理だと思います。非同期で必ず処理しましょう。
画像の非同期ロードはライブラリを使った方が早いと思います。


###ヘッダーやフッタをつけたいよ！
tableView.tableHeaderView tableView.tableFooterView に突っ込む方法を書いてあるのが多いんですが、今回はもっと簡単な方法としてStoryboardなどでこれらのビューを直接突っ込んで管理できるのでおすすめ。
テーブルビューの上や下にUIViewをドラッグすると

UIViewをIB上で直接追加できます。

後はIBでレイアウトをくめばok



##使用するクラス、フレームワーク、ライブラリ

###ビュー
UITableViewController
https://developer.apple.com/library/ios/documentation/uikit/reference/UITableView_Class/Reference/Reference.html

###画像非同期読み込み
AFNetworking
https://github.com/AFNetworking/AFNetworking
AFNetworkingにもUIImageViewのカテゴリがあります。cacheの実装上version2を使うのが吉。

SDWebImage
https://github.com/rs/SDWebImage

###キャッシュ
NSCache
https://developer.apple.com/library/mac/documentation/Cocoa/Reference/NSCache_Class/Reference/Reference.html

TMCache
https://github.com/tumblr/TMCache
tumblr製のキャッシュ. ほかでも使えそうです。

##UI参考
http://pttrns.com/categories/1-activity-feeds


#Instagramみたいなカメラアプリを作りたいんだ！

アプリを作り始めるとやっぱりカメラや写真などを扱うアプリを作りたくなるはずです。

##ここがポイント

###写真の向きが何かおかしいよ！
写真の向きは、保存されている向きと表示されてる向きは違うため、処理する場合にそこを意識する場面が多々あります。

###かっこいいフィルターをつけたり、デコったりしたいよ！
自前実装は難しいので簡単にやるならライブラリを使いましょう

フィルター処理ならGPUImageを使うのと、
https://github.com/BradLarson/GPUImage
フル機能の編集機能を簡単に組み込みたい場合はAviaryを入れるとよいでしょう
http://developers.aviary.com/

パフォーマンスはGPUImageの方がいいですが、CoreImageも場面によっては使えそうです。

###自分でカメラロールのデータを処理したいんだけど！
AssetsLibaryを使いましょう。扱うのがちょっと難しいかもしれませんが、必須です。
取得した写真をきれいに並べたい場合はUICollectionViewControllerで表示すればいいですね

##使用するクラス、フレームワーク、ライブラリ

###ビュー
UIImagePickerViewController
https://developer.apple.com/library/ios/documentation/uikit/reference/UIImagePickerController_Class/UIImagePickerController/UIImagePickerController.html

UICollectionViewController
https://developer.apple.com/library/ios/documentation/uikit/reference/UICollectionViewController_clas/Reference/Reference.html

##画像処理
AssetsLibrary
https://developer.apple.com/library/ios/documentation/AssetsLibrary/Reference/AssetsLibraryFramework/_index.html

GPUImage
https://github.com/BradLarson/GPUImage

Aviary
http://developers.aviary.com/

CoreImage
https://developer.apple.com/library/ios/documentation/graphicsimaging/reference/CoreImageFilterReference/Reference/reference.html


##UI参考
http://pttrns.com/categories/7-capture

http://pttrns.com/categories/5-photos


#ページをめくったりする電子書籍アプリ作りたいんだけど！


例えば本を読むようなアプリを作りたい！といった場合,iOSでは実現は簡単にできます。

##ここがポイント

##ページの遷移のアニメーションを変えたいよ！
iOS6.0以降よりページめくり以外に通常のスクロールも増えているので活用できる場面がちょっとだけふえました。
UIPageViewControllerTransitionStylePageCurl
UIPageViewControllerTransitionStyleScroll


##使用するクラス、フレームワーク、ライブラリ

UIPageViewController
https://developer.apple.com/library/ios/documentation/uikit/reference/UIPageViewControllerClassReferenceClassRef/UIPageViewControllerClassReference.html


#vineみたいな動画のアプリを作ってみたいんだけど


写真アプリの次のフェーズとして動画のアプリがここ最近増えてます。今がその流れに乗り時です！


##ここがポイント

###動画を撮影したい! 動画を加工したい！
AVFoundationフレームワークを使うと色々できます
https://developer.apple.com/library/ios/documentation/AVFoundation/Reference/AVFoundationFramework/_index.html

またまたGPUImageにお世話になるのが簡単です。撮影の機能もあり、フィルターもかけれます。
https://github.com/BradLarson/GPUImage

###動画の向きが何かおかしいよ！
動画も写真と同じく表示の向きと保存の向きが違うので注意が必要です。

###カメラロールから動画だけとりたいんだけど
UIImagePickerControllerならmediaTypeにpublic.movieをセット

```objc
_imagePickerController.mediaTypes = [NSArray arrayWithObjects:@"public.movie", nil];
```

AssetsLibraryで処理する場合はfilterにallvidesoをセット

```objc
[assetsGroup setAssetsFilter:[ALAssetsFilter allVideos]];
```

##使用するクラス、フレームワーク、ライブラリ
AVFoundation
https://developer.apple.com/library/ios/documentation/AVFoundation/Reference/AVFoundationFramework/_index.html

AssetsLibrary
https://developer.apple.com/library/ios/documentation/AssetsLibrary/Reference/AssetsLibraryFramework/_index.html

GPUImage
https://github.com/BradLarson/GPUImage



#ミュージックアプリを作りたいよ！

音楽プレーヤーとしても便利なiPhoneだからこそ、音楽との連携はまだまだ可能性がありますね。

##ここがポイント

###iPhoneに入っている音楽を取得したいんだけど
組み込みのPickerを使いたい場合はMPMediaPickerControllerをつかえばok

```objc

// 呼び出し
MPMediaPickerController *mediaPickerController = [[MPMediaPickerController alloc] init];
mediaPickerController.delegate = self;
mediaPickerController.allowsPickingMultipleItems = NO;
[self presentModalViewController:_mediaPickerController animated:YES];


// delegate
- (void)mediaPickerDidCancel:(MPMediaPickerController *)mediaPicker{
[self dismissModalViewControllerAnimated:YES];
}

- (void) mediaPicker: (MPMediaPickerController *) mediaPicker
didPickMediaItems: (MPMediaItemCollection *) collection
{
// 取得したメディアアイテム
MPMediaItem *item = [collection representativeItem];

// media itemにたいして プロパティ取得

NSString *title = [_item valueForProperty: MPMediaItemPropertyTitle];
NSString *artistName = [_item valueForProperty: MPMediaItemPropertyArtist];
NSString *albumName = [_item valueForProperty: MPMediaItemPropertyAlbumTitle];
NSString *totalPlaybackTime =[_item valueForProperty:MPMediaItemPropertyPlaybackDuration];

MPMediaItemArtwork *artwork = [_item valueForProperty: MPMediaItemPropertyArtwork];

}
```

###アプリを閉じても音楽を再生させたい！
再生するときは MPMusicPlayerControllerを使うのですが、注意点としてアプリをとじでも再生したままにしたい場合はiPodMusicPlayerのinstanceを取得します。

```objc
MPMusicPlayerController *player = [MPMusicPlayerController iPodMusicPlayer];
[player setNowPlayingItem:item];
[player play];
```

###今聞いてる音楽を取得したいんだけど
NSNotificationCenterでMPMusicPlayerControllerNowPlayingItemDidChangeNotificationをobserveします。

```objc
MPMusicPlayerController *player = [MPMusicPlayerController iPodMusicPlayer];

NSNotificationCenter *noteCenter = [NSNotificationCenter defaultCenter];

//　再生曲が変化した時の通知先を登録
[noteCenter addObserver:self selector:@selector(didItemChanged:) name:MPMusicPlayerControllerNowPlayingItemDidChangeNotification object:_player];

- (void)didItemChanged:(id)object
{
// playerからitemを取得
MPMediaItem *currentItem = [player nowPlayingItem];

}
```

###音楽の情報を引っ張ってきたいなあ
MPMediaQueryで操作すればOK

```objc
// 例：アルバム取得
MPMediaQuery *query = [MPMediaQuery albumsQuery];
NSMutableArray *list = [[NSMutableArray alloc] init ];
for(MPMediaItemCollection *collection in [query collections] ){
[list addObject:
[NSMutableDictionary dictionaryWithObjectsAndKeys:
[[collection representativeItem] valueForProperty:MPMediaItemPropertyAlbumTitle],@"title",
[[collection representativeItem] valueForProperty:MPMediaItemPropertyAlbumPersistentID],@"id",
nil]
];
}
```

###使用するクラス、フレームワーク、ライブラリ
MediaPlayer
https://developer.apple.com/library/ios/documentation/MediaPlayer/Reference/MediaPlayer_Framework/_index.html



ざっくりと説明をしたので、ここもっと深堀って欲しいとかあれば別で書きたいと思います。




# 最近の記事

[限界までUXを向上させる! Facebook paperのようなアプリを最新UIライブラリAsyncDisplayKitでヌルヌルな操作感を実現しよう！](http://qiita.com/appwatcher/items/bc6d97a80c847206ba8e)

[あらゆる「モノ」との連携するIoT時代に向けて。iOS と AndroidのBluetooth LE対応状況を確認しておこう](http://qiita.com/appwatcher/items/c6e7e5767ba26aa6558e)

[作ったアプリをブラウザ即見せでモチベーションアップ！！TestFlightよりお手軽なアプリ配布サービスappetize.io](http://qiita.com/appwatcher/items/da77b66cce3c60e50d22)

##### appwchr post
----

[次世代のスーパーエンジニアたちも学ぶ！マインクラフトで触れる技術たちその1](http://qiita.com/appwatcher/items/05513e170b42b09ecd9a)

[あんなすごいエンジニアともであえるかも？？Qiitaユーザーが集まるSlack Teamを作ってみたよ！](http://qiita.com/appwatcher/items/00faadbf02f691186a54)

[goからiOSまで一人でアプリ開発をしてたらいつの間にかマインクラフトエンジニアになった話](http://qiita.com/appwatcher/items/6c0280cda9c4c8b3c65f)

[API開発の効率化の架け橋！APIのStubサーバーを導入して,API開発に効率化、スピード化、柔軟性を手に入れよう！](http://qiita.com/appwatcher/items/49807e72d9600db7196d)

[アプリエンジニアから見てAPI設計において気をつけてもらえるとうれしいこと](http://qiita.com/appwatcher/items/4a0dd09c393cc70d961a)

[Goodbye... Jenkins... Jenkinsを卒業してお手軽CI! iOSもAndroidもCircle CIでアプリのCIを回そう](http://qiita.com/appwatcher/items/4cdf39804d6e46ab7af5)

[まだTestFlight使ってたの？急げ！終了目前のTestFlightから,今すぐにiOSもDeployGateに移行しよう！移行パターンも紹介するよ。](http://qiita.com/appwatcher/items/632460e15fbdb81b7a71)

[Swiftを使ってみて直面した闇。現時点で現場でSwiftを採用すべきかどうかの判断材料](http://qiita.com/appwatcher/items/50295e82ab0095902aaa)

[iOSの開発をする上で絶対に使うべき！外せない！webサービス、開発ツール集【完全版】](http://qiita.com/appwatcher/items/07a3babcb9b6cefb307e)

[注目のiBeacomなどの波に乗り遅れないために！iOSのBluetooth開発を容易にするライブラリを書きました。]
(http://qiita.com/appwatcher/items/7491beffd7260b713542)

[まだまだあった！iOSの開発を劇的に改善する最新のwebサービス、開発ツール集１]
(http://qiita.com/appwatcher/items/f0024fe2ac34da345f04)

[さらに快適なアプリ開発を！iOSの開発をもっと劇的に改善する最新のwebサービス、開発ツール集2]
(http://qiita.com/appwatcher/items/c15d7311e71b4c2b77f1)

[スパゲッティから脱出！iOS開発における遷移の問題をすっきり解決する便利ルーティングライブラリをご紹介]
(http://qiita.com/appwatcher/items/259e8d13fff0547e90af)

# あらかじめ読んでおきたい記事

- [Qiita - 【PHP超入門】クラス～例外処理～PDOの基礎](http://qiita.com/7968/items/6f089fec8dde676abb5b) by @7968

# 初心者がやりがちなミス

以下のどれかに1つでも当てはまるコードは見直す必要があります．付録にリンクを貼っておきましたので，「該当するかも？」という人はクリックして飛んで読んでください．太字にしてあるものは<ins>脆弱性に直結する危険度の高いもの</ins>です．

- [`mysql_query` などの非推奨関数を利用している](#mysql_query-%E3%81%AA%E3%81%A9%E3%81%AE%E9%9D%9E%E6%8E%A8%E5%A5%A8%E9%96%A2%E6%95%B0%E3%82%92%E5%88%A9%E7%94%A8%E3%81%97%E3%81%A6%E3%81%84%E3%82%8B)
- [`SET NAMES` あるいは `SET CHARACTER SET` などで文字コードを指定している<br>そもそもデータベースで使用する文字コードの指定をしていない](#set-names-%E3%81%82%E3%82%8B%E3%81%84%E3%81%AF-set-character-set-%E3%81%AA%E3%81%A9%E3%81%A7%E6%96%87%E5%AD%97%E3%82%B3%E3%83%BC%E3%83%89%E3%82%92%E6%8C%87%E5%AE%9A%E3%81%97%E3%81%A6%E3%81%84%E3%82%8B%E3%81%9D%E3%82%82%E3%81%9D%E3%82%82%E3%83%87%E3%83%BC%E3%82%BF%E3%83%99%E3%83%BC%E3%82%B9%E3%81%A7%E4%BD%BF%E7%94%A8%E3%81%99%E3%82%8B%E6%96%87%E5%AD%97%E3%82%B3%E3%83%BC%E3%83%89%E3%81%AE%E6%8C%87%E5%AE%9A%E3%82%92%E3%81%97%E3%81%A6%E3%81%84%E3%81%AA%E3%81%84)
- **[`"SELECT * FROM users WHERE id = '$id'"` のように変数展開を使ってSQL文を組み立てている](#select--from-users-where-id--id-%E3%81%AE%E3%82%88%E3%81%86%E3%81%AB%E5%A4%89%E6%95%B0%E5%B1%95%E9%96%8B%E3%82%92%E4%BD%BF%E3%81%A3%E3%81%A6sql%E6%96%87%E3%82%92%E7%B5%84%E3%81%BF%E7%AB%8B%E3%81%A6%E3%81%A6%E3%81%84%E3%82%8B)**
- [`$_POST['id']` などの外部入力からきた変数が定義されているかどうか確認していない<br>それらが文字列であるかどうかの確認をしていない<br>**それらを出力する際に `htmlspecialchars` 関数を利用していない**](#_postid-%E3%81%AA%E3%81%A9%E3%81%AE%E5%A4%96%E9%83%A8%E5%85%A5%E5%8A%9B%E3%81%8B%E3%82%89%E3%81%8D%E3%81%9F%E5%A4%89%E6%95%B0%E3%81%8C%E5%AE%9A%E7%BE%A9%E3%81%95%E3%82%8C%E3%81%A6%E3%81%84%E3%82%8B%E3%81%8B%E3%81%A9%E3%81%86%E3%81%8B%E7%A2%BA%E8%AA%8D%E3%81%97%E3%81%A6%E3%81%84%E3%81%AA%E3%81%84%E3%81%9D%E3%82%8C%E3%82%89%E3%81%8C%E6%96%87%E5%AD%97%E5%88%97%E3%81%A7%E3%81%82%E3%82%8B%E3%81%8B%E3%81%A9%E3%81%86%E3%81%8B%E3%81%AE%E7%A2%BA%E8%AA%8D%E3%82%92%E3%81%97%E3%81%A6%E3%81%84%E3%81%AA%E3%81%84%E3%81%9D%E3%82%8C%E3%82%89%E3%82%92%E5%87%BA%E5%8A%9B%E3%81%99%E3%82%8B%E9%9A%9B%E3%81%AB-htmlspecialchars-%E9%96%A2%E6%95%B0%E3%82%92%E5%88%A9%E7%94%A8%E3%81%97%E3%81%A6%E3%81%84%E3%81%AA%E3%81%84)
- [SQLの `LIKE` 演算子を使っているのに `%` `_` `\` のエスケープをしていない](#sql%E3%81%AE-like-%E6%BC%94%E7%AE%97%E5%AD%90%E3%82%92%E4%BD%BF%E3%81%A3%E3%81%A6%E3%81%84%E3%82%8B%E3%81%AE%E3%81%AB--_--%E3%81%AE%E3%82%A8%E3%82%B9%E3%82%B1%E3%83%BC%E3%83%97%E3%82%92%E3%81%97%E3%81%A6%E3%81%84%E3%81%AA%E3%81%84)
- [HTMLの `<body></body>` の中にデータベース接続処理を書いている<br>`echo()` や `print()` をベタ書きしている<br>Content-Typeを `text/plain` に変更せずに `exit()` や `die()` で強制終了処理を記述している](#html%E3%81%AE-bodybody-%E3%81%AE%E4%B8%AD%E3%81%AB%E3%83%87%E3%83%BC%E3%82%BF%E3%83%99%E3%83%BC%E3%82%B9%E6%8E%A5%E7%B6%9A%E5%87%A6%E7%90%86%E3%82%92%E6%9B%B8%E3%81%84%E3%81%A6%E3%81%84%E3%82%8Becho-%E3%82%84-print-%E3%82%92%E3%83%99%E3%82%BF%E6%9B%B8%E3%81%8D%E3%81%97%E3%81%A6%E3%81%84%E3%82%8Bcontent-type%E3%82%92-textplain-%E3%81%AB%E5%A4%89%E6%9B%B4%E3%81%9B%E3%81%9A%E3%81%AB-exit-%E3%82%84-die-%E3%81%A7%E5%BC%B7%E5%88%B6%E7%B5%82%E4%BA%86%E5%87%A6%E7%90%86%E3%82%92%E8%A8%98%E8%BF%B0%E3%81%97%E3%81%A6%E3%81%84%E3%82%8B)

# PDOの基本

PHPでデータベースに接続するためには，現在はPDOを使う方法が主流であると言えるでしょう．PDOの基本的な使い方を確認していきます．内容によって，「前でさらっと書いてあることの定義が後で出てくる」など，どうしても多少前後してしまう部分はありますが，特に気にせずに読み流してください．

## データベースに接続

[PDO::__construct] メソッドを使用してインスタンスを生成します．コンストラクタなので，実際には直接これを呼び出すコードは書かずに， **new演算子** を用います．

```php
$pdo = new PDO($dsn, $username, $password, $driver_options);
```

引数は以下の通りです．

### `$dsn`

データベースに接続するために必要な情報です． (Data Source Name)
以下に各データベース製品に応じたDSNの書き方が掲載されています．

- [PHP Manual - PDOクラスのデータベース別DSN一覧](http://www.php.net/manual/ja/pdo.drivers.php)

MySQLの基本的な書き方を例に挙げます．

**`mysql:dbname=test;host=localhost;charset=utf8mb4`**

- 頭にデータベースの種類を指定して `:` で区切る．
- 各項目は `項目名=値` とし， `;` で区切る．

#### <font color="silver">dbname</font>

データベース名を指定します．基本的には必須です．但し，データベースを後で `USE test` のようにSQL文で選択する場合，省略することができます．

#### <font color="silver">host</font>

ホスト名またはIPアドレスを指定します．ローカル環境で動かす場合，省略しても問題ない場合が多いです．`localhost` は自分自身のホスト名， `127.0.0.1` は自分自身のIPアドレスを指します．どちらを用いても問題が発生する可能性があるので，適宜問題のない方を選択してください．

- Linux環境はホスト名推奨
- [upsilonさん: MySQLではlocalhostと127.0.0.1で接続方法が変わるため注意が必要](http://qiita.com/mpyw/items/b00b72c5c95aac573b71#comment-e9db50fff9bffa1dd6f8)
- Windows環境はIPアドレス推奨
- [AH-2 - Windowsでlocalhostへの接続が遅い(解決方法)](http://www.ah-2.com/2012/01/28/win_localhost_slow.html)

#### <font color="silver">charset</font>

文字セットを指定します．`SET NAMES`は避けて，ここで指定するべきです．`UTF-8`ではなく`utf8`であることに注意してください．ハイフンは入りません．

**【2016/12/17 追記】**
**MySQL5.5.3以降の場合は，4バイトからなる絵文字なども正常に取り扱える`utf8mb4`を使用することを強く推奨します。**

### `$username`

ユーザー名．ルート権限を使う場合，デフォルトでは `root` です．

### `$password`

パスワード．ルート権限を使う場合，デフォルトでは空白です．

### `$driver_options`

接続時のオプションを連想配列で渡します．

- キーはあらかじめ用意されている定数を取る．
- 値はあらかじめ用意されている定数以外に，論理値・文字列などの一般的な値も取り得る．

```php
[
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
PDO::ATTR_EMULATE_PREPARES => false,
]
```

オプションの内容については後で触れます．

## 接続後にオプションを指定

[PDO::setAttribute] メソッドを使用します．多くのオプションはコンストラクタの `$driver_options` で指定してもこちらで指定しても大差はありませんが， `PDO::MYSQL_ATTR_INIT_COMMAND` `PDO::ATTR_PERSISTENT` など，一部コンストラクタ専用のものがあります．

```php
$pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
$pdo->setAttribute(PDO::ATTR_EMULATE_PREPARES, false);
```

## よく使われるドライバオプションとその値

### `PDO::ATTR_ERRMODE`

SQL実行でエラーが起こった際にどう処理するかを指定します．デフォルトは `PDO::ERRMODE_SILENT` です．

- **`PDO::ERRMODE_EXCEPTION`** を設定すると例外をスローしてくれる．これを選択しておくのが一番無難．
- `PDO::ERRMODE_WARNING` はSQLで発生したエラーをPHPのWarningとして報告する．<br><ins>[PDOStatement::execute] メソッドの返り値が `false` でないかを毎回のように確認する必要がある</ins>．
- `PDO::ERRMODE_SILENT` は何も報告しない．<br><ins>[PDOStatement::execute] メソッドの返り値が `false` でないかを毎回のように確認する必要がある</ins>．

### `PDO::ATTR_DEFAULT_FETCH_MODE`

[PDOStatement::fetch] メソッドや [PDOStatement::fetchAll] メソッドで引数が省略された場合や，ステートメントがforeach文に直接かけられた場合のフェッチスタイルを設定します．デフォルトは`PDO::FETCH_BOTH`です．

- `PDO::FETCH_BOTH`<br>
カラム番号とカラム名の両方をキーとする連想配列で取得する．
- `PDO::FETCH_NUM`<br>
カラム番号をキーとする配列で取得する．
- **`PDO::FETCH_ASSOC`**<br>
カラム名をキーとする連想配列で取得する．これが一番ポピュラーな設定．
- `PDO::FETCH_OBJ`<br>
カラム名をプロパティとする基本オブジェクトで取得する．

### `PDO::ATTR_EMULATE_PREPARES`

データベース側が持つ「プリペアドステートメント」という機能のエミュレーションをPDO側で行うかどうかを設定します．

- PHP5.1のデフォルトは `false`
- <ins>PHP5.2以降のデフォルトは `true`</ins>

この設定で，いくつかPDOの挙動に違いが表れます．

- プリペアドステートメントのためにデータベースサーバと通信する必要が無くなるため，エミュレーションを行ったほうがパフォーマンスは向上する．
- 存在しないテーブル名やカラム名をSQL文に持つプリペアドステートメントを発行したとき，エミュレーションOFFの場合はすぐにエラーが発生するが，エミュレーションONの場合は実際にクエリを実行するまでエラーが発生するかどうかわからない．
- エミュレーションがONの場合のみ， `;` 区切りで複数のSQL文を1つのクエリで実行することができる．

その他，どちらにも利点と欠点があるので，違いは追って見ていき，最後に表にまとめることにします．

```php:PDOクラスのエミュレーションを無効にする
$pdo->setAttribute(PDO::ATTR_EMULATE_PREPARES, false);
```

### `PDO::ATTR_PERSISTENT` (コンストラクタ専用)

`true` を設定すると，スクリプトが終了してもデータベースへの接続を維持し，次回に再利用します．規模が大きくなってくると設定する恩恵が大きくなりますが，ほそぼそと練習用サイトを作っているうちは役に立たないでしょう．

### `PDO::MYSQL_ATTR_USE_BUFFERED_QUERY` (MySQL専用)

`true` のとき， バッファクエリを使用します．デフォルト値はバージョンによって異なるようで，不明です．PHP5.3の時代には既にデフォルトが `true` で今も変わっていない…？少なくとも，私が確認できる限りの最近バージョンではデフォルトは `true` です．

- **バッファクエリ**:<br>全ての情報をデータベースサーバから取得してきておいて，PHPに1件ずつ取り出させる
- **非バッファクエリ**:<br>1件ごとにデータベースサーバと通信を行って，PHPに取り出させる

取得してくる情報がメモリに収まりきらない莫大な量である，といった非常に特殊なケースを除けば，バッファクエリを選択しておく方が無難です．サーバ負荷も軽減され，途中までフェッチしたところで突然例外が発生するような事態も避けられます．また，非バッファクエリには複数同時にクエリを実行できないなどの大きな欠点もあります．基本的にこれは，データベースから取得したデータでHTMLを表示する用途ではなく，<ins>コマンドラインからバッチ処理を実行する</ins>用途で使われます．

### `PDO::MYSQL_ATTR_INIT_COMMAND` (MySQL専用) (コンストラクタ専用)

接続した直後に実行されるクエリをここに書きます．

## 基本コーディング

書き方のテンプレです．

```html+php
<?php

try {

/* リクエストから得たスーパーグローバル変数をチェックするなどの処理 */

// データベースに接続
$pdo = new PDO(
'mysql:dbname=testdb;host=localhost;charset=utf8mb4',
'root',
'',
[
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
]
);

/* データベースから値を取ってきたり， データを挿入したりする処理 */

} catch (PDOException $e) {

// エラーが発生した場合は「500 Internal Server Error」でテキストとして表示して終了する
// - もし手抜きしたくない場合は普通にHTMLの表示を継続する
// - ここではエラー内容を表示しているが， 実際の商用環境ではログファイルに記録して， Webブラウザには出さないほうが望ましい
header('Content-Type: text/plain; charset=UTF-8', true, 500);
exit($e->getMessage());

}

// Webブラウザにこれから表示するものがUTF-8で書かれたHTMLであることを伝える
// (これか <meta charset="utf-8"> の最低限どちらか1つがあればいい． 両方あっても良い．)
header('Content-Type: text/html; charset=utf-8');

?>
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>Example</title>
</head>
<body>
<!-- ここではHTMLを書く以外のことは一切しない -->
</body>
</html>
```

### 参考: コンストラクタでのエラーモードってどうなるの？

PDOのコンストラクタは `PDO::ERRMODE_EXCEPTION` の有無に関わらず **PDOException** をスローしますが， <ins>ホストに接続できなかった</ins>場合などに **Warning** を発生します．普通は気に留める必要はありませんが，ホストを動的に指定させるようなプログラムを書いているならば， [set_error_handler](http://www.php.net/manual/ja/function.set-error-handler.php) 関数を使って **ErrorException** に変換しなければ，例外処理を行うことができません．

## [PDO::query] メソッドで直接クエリを実行する


ユーザー入力を伴わないクエリに関しては単に [PDO::query] メソッドを実行すればいいだけです．返り値は **PDOStatement** となります．

```php:全員を取得する
$stmt = $pdo->query('SELECT * FROM users');
```

## [PDO::exec](http://www.php.net/manual/ja/pdo.exec.php) メソッドで直接クエリを実行する

ユーザー入力を伴わないクエリで， **INSERT** や **UPDATE** 等で作用した件数を直接返り値に欲しい場合は [PDO::exec] メソッドを代わりに使います．特に結果を必要としない場合においてもこちらを使用すべきです．後に登場する [PDOStatement::execute] と紛らわしいので注意してください．

```php:全員の年齢を+1し，その対象となった人数を返り値として取得する
$count = $pdo->exec('UPDATE users SET age = age + 1');
```

## [PDO::prepare] → [PDOStatement::bindValue] → [PDOStatement::execute] の3ステップでクエリを実行する

ユーザー入力を受け取ってSQL文を動的に生成する場合は **プリペアドステートメント** と **プレースホルダ** を使わなければなりません．

- **プレースホルダ**:<br>直訳すると「場所取り」．何かユーザ入力を当てはめる場所としてあらかじめ確保しておくもの．
- **プリペアドステートメント**:<br>直訳すると「予約文」．文を予約したもの．通常，「予約文」は「場所取り」を使うために作られる．もし「場所取り」が無ければ普通に [PDO::query] などで実行するだけで十分なためである．

プレースホルダには2種類あり，**疑問符プレースホルダ** を使う方法と， **名前付きプレースホルダ** を使う方法があります．もしこれらが混ざってしまうと

```
SQLSTATE[HY093]: Invalid parameter number: mixed named and positional parameters
```

が発生するので，どちらか一方のみを選択してください．

### 疑問符プレースホルダ

- `?` の「番目」は **1** から始まる．
- `PDO::PARAM_STR` は省略することが出来る．
- エミュレーションがONの場合には正しくキャストしてくれないバグのようなものが仕様として存在するため，<ins>文字列以外のものを扱う際に明示的なキャストが必要</ins>．
- `NULL` 値に関しては `PDO::PARAM_NULL` が暗黙的に使用される．

```php:エミュレーションがONの場合はこうする必要がある
$stmt = $pdo->prepare('SELECT * FROM users WHERE gender = ? AND age = ?');
$stmt->bindValue(1, $gender);
$stmt->bindValue(2, (int)$age, PDO::PARAM_INT);
$stmt->execute();
```

```php:エミュレーションがOFFの場合はこれでもOK
$stmt = $pdo->prepare('SELECT * FROM users WHERE gender = ? AND age = ?');
$stmt->bindValue(1, $gender);
$stmt->bindValue(2, $age, PDO::PARAM_INT);
$stmt->execute();
```

- 番目で整数以外を指定した場合，適当な変換が行われる． (但し，こんなコードは書くべきではない)

```php:良い例
$stmt->bindValue('2', $age, PDO::PARAM_INT);
$stmt->bindValue('02', $age, PDO::PARAM_INT);
$stmt->bindValue('+02', $age, PDO::PARAM_INT);
$stmt->bindValue('2e0', $age, PDO::PARAM_INT);
$stmt->bindValue('00002.9999', $age, PDO::PARAM_INT);
```

```php:悪い例
// SQLSTATE[HY093]: Invalid parameter number: Columns/Parameters are 1-based
$stmt->bindValue(-2, $age, PDO::PARAM_INT);

// オーバーフローして3になる
// SQLSTATE[HY093]: Invalid parameter number: parameter was not defined
$stmt->bindValue('00002.999999999999999999999999999', $age, PDO::PARAM_INT);

// Notice: A non well formed numeric value encountered
$stmt->bindValue('2a', $age, PDO::PARAM_INT);
```

### 名前付きプレースホルダ

- `:` を頭につけ，半角英数字とアンダースコアにて構成する．
- バインド時の頭の `:` は省略することが出来る．

```php:こちらも同様にエミュレーションがONならば明示的なキャストを忘れない
$stmt = $pdo->prepare('SELECT * FROM users WHERE age = :age AND gender = :gender');
$stmt->bindValue(':age', (int)$age, PDO::PARAM_INT);
$stmt->bindValue(':gender', $gender);
```

```php:頭のコロンを省略したケース
$stmt->bindValue('gender', $gender);
```

- <ins>エミュレーションがONの場合のみ</ins>，同名のプレースホルダを複数使うことが出来る．

```php:IDが20で年齢も20歳の人を取得
$n = 20;
$stmt = $pdo->prepare('SELECT * FROM users WHERE age = :n AND id = :n');
$stmt->bindValue(':n', (int)$age, PDO::PARAM_INT);
$stmt->execute();
```

なお， 値を即時にバインドするのではなく，変数を参照的にバインドしておき，実際に値をバインドするのは実行時になる [PDOStatement::bindParam] メソッドもありますが，原則的にこちらを使う必要はありません．<ins>エミュレーションがONの場合</ins>，実行後にバインドした変数が文字列型にされる仕様もあるので注意してください．

- [Qiita - 最近PDOを使っていてハマったこと2つ．](http://qiita.com/_dozen_/items/e3c00a0a581378a4cc70)

## [PDO::prepare] → [PDOStatement::execute] の2ステップでクエリを実行する

[PDOStatement::execute] メソッドの引数に配列を渡すと，それらを全てバインドしたあとそのままSQLを実行してくれます．但し，以下の条件に注意してください．

- <ins>`NULL` 値以外は全て `PDO::PARAM_STR` 扱いになる</ins> ．もし間違った型でバインドをしても，MySQL/SQLiteはデータベース側で自動的にキャストし直してくれるが，パフォーマンスの低下やバグの原因になるので，可能な限り避けたほうがいい．<ins>PostgreSQLの場合はエラーになる</ins>．
- また， <ins>既に [PDOStatement::bindValue] メソッドで値がバインドされていた場合でも，それらは全て無視される</ins>．これを用いる場合，全てのバインドをこの引数で行わなければならない．

### 疑問符プレースホルダ

[PDOStatement::bindValue] メソッドを用いたときと異なり，`?` の「番目」が **0** から始まることに注意してください．

```php
$stmt = $pdo->prepare('SELECT * FROM users WHERE city = ? AND gender = ?');
$stmt->execute([$city, $gender]);
```

```php:キーを適切に設定すれば順番を変えて指定することも可能
$stmt->execute([1 => $gender, 0 => $city]);
```

### 名前付きプレースホルダ

```php
$stmt = $pdo->prepare('SELECT * FROM users WHERE city = :city AND gender = :gender');
$stmt->execute([':city' => $city, ':gender' => $gender]);
```

```php:頭のコロンは省略することが出来る
$stmt->execute(['city' => $city, 'gender' => $gender]);
```

```php:compact関数を活用する例
$stmt->execute(compact('city', 'gender'));
```

## `SELECT` の結果を取得する

### 結果の型

#### <font color="silver">MySQL</font>

| データベース | PHP<br />(エミュレーション無しmysqlnd) | PHP<br />(libmysqlclient)<br />(エミュレーション有りmysqlnd)<br /> |
|:--------:|:--------:|:--------:|
| NULL | NULL | NULL |
| 文字列 | String | String |
| 日付 | String | String |
| タイムスタンプ | Integer | String |
| 論理値 | **Integer** | String |
| PHPで扱える<ins>値の</ins>整数 | Integer | String |
| PHPで扱えない<ins>値の</ins>整数 | String | String |
| 浮動小数点数 | Float | String |

エミュレーションに関するオプションは `PDO::ATTR_EMULATE_PREPARES` という命名ではありますが，<ins>プリペアドステートメントを使用しない場合にも影響が及ぶ</ins>ことに注意してください．

#### <font color="silver">PostgreSQL</font>

| データベース | PHP |
|:--------:|:--------:|
| NULL | NULL |
| 文字列 | String |
| 日付 | String |
| タイムスタンプ | Integer |
| 論理値 | Boolean |
| PHPで扱える<ins>型の</ins>整数 | Integer |
| PHPで扱えない<ins>型の</ins>整数 | String |
| 浮動小数点数 | **String** |

#### <font color="silver">SQLite</font>

| データベース | PHP |
|:--------:|:--------:|
| NULL | NULL |
| その他 | String |

### [PDO::setAttribute](http://www.php.net/manual/ja/pdo.setattribute.php) で取得する型を変更できるケース

#### `PDO::ATTR_ORACLE_NULLS`

| データベース上 |**`PDO::NULL_EMPTY_STRING`**|**`PDO::NULL_TO_STRING`**|
|:--------:|:--------:|:--------:|
| NULL | NULL | "" |
| "" | NULL | "" |

オプション名に `ORACLE` という名前が入っていますが，Oracle以外のデータベースでも利用することができます．

#### `PDO::ATTR_STRINGIFY_FETCHES`

`true` に設定すると，エミュレーションがOFFの場合に数値が文字列化されます．<ins>エミュレーションがONの場合は，この設定に関わらず常に文字列化されます</ins>．

### [PDOStatement::fetch]

カーソルをずらしながら，指定したフェッチモードで1行ずつ取得していきます．

- 引数を省略した場合はデフォルトフェッチモードが使用される．
- 全ての取得が終わると常に `false` を返す．

デフォルトフェッチモードを `PDO::FETCH_ASSOC` に設定した際の例を示します．

```php:一番基本的な方法
while ($row = $stmt->fetch()) {
printf("%s lives in %s<br />\n", $row['name'], $row['city']);
}
```

```php:vprintf()関数を使った応用
while ($row = $stmt->fetch()) {
vprintf("%s lives in %s<br />\n", $row);
}
```

PDOStatementクラスはTraversableインターフェースを実装しているため，デフォルトフェッチモードを使う場合，while文の代わりにforeach文でもっとスマートに書くことができます．但し，<ins>HTML表示のために変数を準備する場合には，多くは配列として持っておく方が都合がいいので，後に紹介する [PDOStatement::fetchAll] メソッドの使用を検討してください</ins>．

```php
foreach ($stmt as $row) {
printf("%s lives in %s<br />\n", $row['name'], $row['city']);
}
```

```php:0から始まるオフセットを取り出すことも出来る
foreach ($stmt as $i => $row) {
printf("[%d] %s lives in %s<br />\n", $i, $row['name'], $row['city']);
}
```

### [PDOStatement::fetchObject](http://www.php.net/manual/ja/pdostatement.fetchobject.php)

連想配列の代わりにstdClassオブジェクトとして取得します．[PDOStatement::fetch](http://www.php.net/manual/ja/pdostatement.fetch.php) で `PDO::FETCH_OBJ` を指定するケースと等価ですが，こちらの方が短く書くことができます．

```php
while ($row = $stmt->fetchObject()) {
printf("%s lives in %s<br />\n", $row->name, $row->city);
}
```

### [PDOStatement::fetchColumn](http://www.php.net/manual/ja/pdostatement.fetchcolumn.php)

特定の1カラムのみを文字列として取得します．[PDOStatement::fetch] で `PDO::FETCH_COLUMN` を指定するケースと等価ですが，こちらの方が短く書くことができます．

- 先頭から数えてそのカラムが何番目にあるかを第1引数として渡す．「番目」は **0** から始まる．省略した場合は 0 を指定したとみなされる．
- 値に `0` が含まれる可能性がある場合は， **`false !==`** の条件判定をしなければならない．

```php
while (false !== $value = $stmt->fetchColumn()) {
echo "{$value}<br />\n";
}
```

### [PDOStatement::fetchAll]

一気に全件取得して2次元配列とします．

- 引数を省略した場合はデフォルトフェッチモードが使用される．

```php
$rows = $stmt->fetchAll();
var_dump($rows);
```

- 特定のカラムだけ一気に全件取得して1次元配列としたい場合，第1引数に **`PDO::FETCH_COLUMN`** を指定し，第2引数にカラムの「番目」を渡す．「番目」は **0** から始まる．省略した場合は 0 を指定したとみなされる．

```php
$values = $stmt->fetchAll(PDO::FETCH_COLUMN);
var_dump($values);
```

### [PDOStatement::setFetchMode](http://www.php.net/manual/ja/pdostatement.setfetchmode.php)

PDOオブジェクト自体にデフォルトフェッチモードを指定する方法を紹介しましたが，このメソッドを利用すれば個別に発行されたPDOStatementオブジェクトに対して後からフェッチモードを指定することができます．引数の渡し方がモードによって異なるので，詳しくはマニュアルを参照してください．

```php:0番目のカラムをforeachで取得していくケース
$stmt->setFetchMode(PDO::FETCH_COLUMN, 0);
foreach ($stmt as $i => $name) { ... }
```

実は… [PDO::query] を用いる場合にも同じ形式でフェッチモードを指定することができます．

```php:0番目のカラムをforeachで取得していくケース
foreach ($pdo->query($sql, PDO::FETCH_COLUMN, 0) as $i => $name) { ... }
```

## `UPDATE`, `INSERT` で作用した行数を取得する

こちらの結果に対してフェッチしようとした場合，`SQLSTATE[HY000]: General error` が発生します．こちらに対して用いることができるのは [PDOStatement::rowCount](http://www.php.net/manual/ja/pdostatement.rowcount.php) メソッドのみです．

```php
printf("%d行に作用しました<br >\n", $stmt->rowCount());
```

## `SELECT` で該当した行数を取得する

基本的に，以下の方法に従います．

- 件数だけでなく結果セットも一緒に欲しい場合， [PDOStatement::fetchAll] メソッドで一気に配列として取得し，それに対してPHPの [count] 関数を使う．
- 件数だけが欲しい場合は， `SELECT COUNT(*) WHERE ...` といったクエリを発行し，その結果を [PDOStatement::fetchColumn] メソッドで得る．

これらの方法が最も推奨されますが，他の方法が無いわけではありません．以下に補足説明を示します．但しこれらはMySQLやPostgreSQLについてのみ当てはまり，<ins>SQLiteには当てはまりません</ins>．

### バッファクエリ使用時

- **SELECT** に対しても常に [PDOStatement::rowCount] メソッドを使うことができる．

### 非バッファクエリ使用時

- [PDOStatement::fetchAll] メソッドを実行した後，つまり<ins>全てのフェッチが終わった後</ins>であれば **SELECT** に対しても [PDOStatement::rowCount] メソッドを使うことができる．
- 結果のフェッチを途中で中断したまま次のクエリ実行に移行するときは， [PDOStatement::closeCursor] メソッドを使ってカーソルを閉じる必要がある．1つ目の結果セットをPDOStatementに保持したまま2つ目のSQLを実行することはできないので，その場合はあらかじめ [PDOStatement::fetchAll] メソッドでデータを退避させておく必要がある．

## データベース接続の切断

データベース処理の最後に

```php
$pdo = null;
```

と書いているコードが散見されますが，ほとんどの場合ではこの記述は不要です．必要になるのは，非バッファクエリを使うようなバッチ処理のシーンのみです．

# エミュレーションに関するまとめ

これまでに何度か登場した，エミュレーションの有無に関する差異を表にまとめます．

| 項目 | エミュレーションON | エミュレーションOFF |
|:----|:---------:|:----:|
| パフォーマンス | ○ | △ |
| `SET NAMES` による安全性 | △ | ○ |
| NULL値をそのままの型で受け取る | ○ | ○ |
| **数値をそのままの型で受け取る**<br />( **mysqlnd** のみが対象) | × | ○ |
| **複数の同名プレースホルダ** | ○ | × |
| **`PDO::PARAM_*` 定数による正しいキャスト** | × | ○ |
| **[PDOStatement::bindParam]** メソッドによる副作用問題 | × | ○ |
| **複文の実行** | ○ | ✕ |

# PDOの応用

## PDOStatementのデータ取得形式を極める

- [Qiita - PDOフェッチパターン大全](http://qiita.com/mpyw/items/d52351bd1a8068344cc2)

## MySQLの暗黙的な型変換を防止する

既に述べたとおり，MySQLは暗黙的な型変換を行います．

```php:もしageが整数型でも，MySQLはエラーを発生しない
$stmt = $pdo->prepare('SELECT * FROM users WHERE age = ?');
$stmt->execute(['20']);
```

もしPostgreSQLのように厳密さを与えたいならば，あらかじめ以下のクエリを実行しておきます．

```php
$pdo->exec("SET SESSION sql_mode='TRADITIONAL'");
```

- [Qiita - MySQLの自動変換が厄介な時の設定](http://qiita.com/yukix/items/c9ad1e38bb98b7c924f3)

## LIKE検索

部分一致のあいまいな検索を行いたい場合，LIKE演算子を使用します．LIKE検索で使われる特殊文字には

- `%` … 任意の0文字以上の文字列
- `_` … 任意の1文字

があるため，これらの文字を普通に検索したい場合にはエスケープが必要となります．MySQLの場合はエスケープ用の文字を省略して `\` にすることが出来ますが，SQLiteなど他のデータベースとの互換性を考慮する場合，エスケープに使用する文字を明示すべきです．例えば `!` を用いる場合は `ESCAPE '!'` とします．なお，エスケープ用の文字が文字列中に含まれているケースにも対応するために，そのエスケープ用の文字自体のエスケープも必要です．

```php:どんなデータベースにも広く使える方法
$stmt = $pdo->prepare("SELECT * FROM users WHERE name LIKE ? ESCAPE '!'");
$stmt->bindValue(1, '%' . preg_replace('/(?=[!_%])/', '!', $name) . '%', PDO::PARAM_STR);
```

```php:MySQL専用の方法
$stmt = $pdo->prepare('SELECT * FROM users WHERE name LIKE ?');
$stmt->bindValue(1, '%' . addcslashes($name, '\_%') . '%', PDO::PARAM_STR);
```

## ブール全文検索

MySQLでブール全文検索を行いたい場合，IN BOOLEAN MODE修飾子を使用します．全文検索関数で使われる特殊文字には

- `+` … 各行に存在しなければならない
- `-` … 各行に存在してはならない
- `@` … 距離
- `<`, `>` … 単語の貢献度
- `(`, `)` … グループ化
- `~` … 否定演算子
- `*` … 切り捨てまたはワイルドカード
- `"` … フレーズ検索

があるため，これらの文字を普通に検索したい場合にはエスケープが必要となります．

```php:MySQL専用の方法
$stmt = $pdo->prepare('SELECT * FROM users WHERE MATCH (description) AGAINST (? IN BOOLEAN MODE)');
$stmt->bindValue(1, addcslashes($name, '\+-@<>()~*"'), PDO::PARAM_STR);
```

## 可変長プレースホルダ

### 固定長プレースホルダではどうなるか

例えば，検索キーワードを複数受け取って特定のカラムがそれらすべてに部分一致するかどうかの検索を行う場合を考えましょう．キーワードの数が2個の場合，実行の流れは次のようになります．

```php
$keywords = ['foo', 'bar'];
foreach ($keywords as $keyword) {
// LIKE検索のために「%キーワード%」の形式にする
$values[] = '%' . preg_replace('/(?=[!_%])/', '!', $keyword) . '%';
}
$sql = "SELECT * FROM books WHERE ((summary LIKE ? ESCAPE '!') AND (summary LIKE ? ESCAPE '!'))";
$stmt = $pdo->prepare($sql);
$stmt->execute($values);
```

### 可変長プレースホルダの導入

ところが，実際は検索キーワードの数が不定個数となるのが一般的です．このような場合にはどうすればいいか？そこで必要になってくるのが，動的にプレースホルダを生成することです．具体例を下に示します．

```php
if ($keywords) {
/* キーワードが1つ以上のときだけ実行 */
foreach ($keywords as $keyword) {
// プレースホルダのLIKE部分を用意
$holders[] = "(summary LIKE ? ESCAPE '!')";
// LIKE検索のために「%キーワード%」の形式にする
$values[] = '%' . preg_replace('/(?=[!_%])/', '!', $keyword) . '%';
}
// AND条件で結合する
$sql = 'SELECT * FROM books WHERE (' . implode(' AND ', $holders) . ')';
// 実行
$stmt = $pdo->prepare($sql);
$stmt->execute($values);
}
```

検索対象のカラムが2つあり， *summary1* と *summary2* の<ins>どちらかに</ins>一致すればOKと見なす場合は次のようにします．OR条件とAND条件を両方用いていることに注意してください．

```php
if ($keywords) {
/* キーワードが1つ以上のときだけ実行 */
foreach ($keywords as $keyword) {
// プレースホルダのLIKE部分を用意
$holders[] = "((summary1 LIKE ? ESCAPE '!') OR (summary2 LIKE ? ESCAPE '!'))";
// LIKE検索のために「%キーワード%」の形式にする
$values[] = $values[] = '%' . preg_replace('/(?=[!_%])/', '!', $keyword) . '%';
}
// AND条件で結合する
$sql = 'SELECT * FROM books WHERE (' . implode(' AND ', $holders) . ')';
// 実行
$stmt = $pdo->prepare($sql);
$stmt->execute($values);
}
```

### 検索キーワードを単語単位に分解する

実際に検索システムを実装するときに，どのようにして検索キーワードを `$keywords` に配列でセットするかどうかが問題となりますが，これは半角スペースで分割させることが一般的であると考えられます．しかし，ここでは半角スペースだけでなく…

- **全てのASCII制御文字**
- 全角スペース
- ハードスペース(&amp;nbsp;)

正規表現を活用して，これらすべてを対象にしてみます．

```php
$q = (string)filter_input(INPUT_GET, 'q');
$regex = "/[\\x0-\x20\x7f\xc2\xa0\xe3\x80\x80]++/u";
$keywords = preg_split($regex, $q, -1, PREG_SPLIT_NO_EMPTY);
```

**`PREG_SPLIT_NO_EMPTY`** フラグを用いることで，空文字列の要素を自動的に除外できるのも [preg_split](http://www.php.net/manual/ja/function.preg-split.php) 関数の強みです．

## トランザクション処理

連続的なSQL実行に一貫性・信頼性を持たせたい場合，「トランザクション」という機能を利用します．

- [Wikipedia - トランザクション処理](http://ja.wikipedia.org/wiki/%E3%83%88%E3%83%A9%E3%83%B3%E3%82%B6%E3%82%AF%E3%82%B7%E3%83%A7%E3%83%B3%E5%87%A6%E7%90%86)

### トランザクションの基本的な利用法

#### 使用されるメソッド

処理の実体はデータベースごとに固有の実装が為されていますが，インタフェースはPDOのメソッドとして抽象化されており，SQL文をデータベースごとに書き分けたりする必要はなくなります．

- [PDO::beginTransaction](http://www.php.net/manual/ja/pdo.begintransaction.php)
- [PDO::commit](http://www.php.net/manual/ja/pdo.commit.php)
- [PDO::rollBack](http://www.php.net/manual/ja/pdo.rollback.php)
- [PDO::lastInsertId](http://www.php.net/manual/ja/pdo.lastinsertid.php) (必要に応じて)

#### ポイント

- Tryブロックを **2重** に設け，例外発生時にはロールバックを実行し，捕捉した例外を必要に応じて<ins>外側のTryブロックに向けてスロー</ins>する．
- 同じ形式のプリペアドステートメントの生成は1回だけにして，それを使いまわすようにした方がパフォーマンスは向上する．

```php:例
try {

// データベースに接続
$pdo = new PDO(
'mysql:dbname=testdb;host=localhost;charset=utf8mb4',
'root',
'',
[
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
]
);

// パラメータ
$from = 'A';
$to = 'B';
$transfer_amount = 12000;

// プリペアドステートメントを用意
$stmt = $pdo->prepare('UPDATE account SET credit = credit + (?) WHERE id = ?');

// トランザクション処理を開始
$pdo->beginTransaction();
try {
// Aの預金残高を減らす
$stmt->bindValue(1, -1 * $transfer_amount, PDO::PARAM_INT);
$stmt->bindValue(2, $from);
$stmt->execute();
// Bの預金残高を増やす
$stmt->bindValue(1, +1 * $transfer_amount, PDO::PARAM_INT);
$stmt->bindValue(2, $to);
$stmt->execute();
// コミット
$pdo->commit();
} catch (PDOException $e) {
// ロールバック
$pdo->rollBack();
// 外側のTryブロックに対してスロー
throw $e;
}

} catch (PDOException $e) {

// 例外メッセージを表示
header('Content-Type: text/plain; charset=UTF-8', true, 500);
exit($e->getMessage());

}
```

### トランザクションの種類

秀逸な記事は太字にして紹介します．

- **[tree-tips - MySQLのトランザクション分離レベル](http://tree-tips.appspot.com/mysql/transaction_isoration/)**
- **[TECHSCORE - トランザクションの定義](http://www.techscore.com/tech/sql/SQL11/11_03.html)**
- **[主に言語とシステム開発に関して - DBの「トランザクション分離レベル」が必要な理由](http://d.hatena.ne.jp/language_and_engineering/20110104/p1)**
- [Wikipedia - トランザクション分離レベル](http://ja.wikipedia.org/wiki/%E3%83%88%E3%83%A9%E3%83%B3%E3%82%B6%E3%82%AF%E3%82%B7%E3%83%A7%E3%83%B3%E5%88%86%E9%9B%A2%E3%83%AC%E3%83%99%E3%83%AB)
- [CUBE SUGAR STORAGE - MySQL を使ってトランザクション分離レベルの違いを試す](http://momijiame.tumblr.com/post/41512778756/mysql)
- [ソフト開発お仕事メモ - \[DB\]H2, Derby, SQLiteの仕様の調査メモ（ロック周り）](http://d.hatena.ne.jp/sekom/20081115/p1)

#### 推奨場面まとめ


#### 各データベース製品のデフォルト

- **MySQL** のInnoDBのデフォルトは **`REPEATABLE READ`** である．
- **PostgreSQL** のデフォルトは **`READ COMMITTED`** である．
- **SQLite** のデフォルトは **`DEFERRED`** であり，これは `READ COMMITTED` に相当する．

#### 分離レベルを設定するSQLの実行

```php:MySQLでの例
$pdo->exec('SET SESSION TRANSACTION ISOLATION LEVEL SERIALIZABLE');
```

```php:PostgreSQLでの例
$pdo->exec('SET SESSION CHARACTERISTICS AS TRANSACTION SERIALIZABLE');
```

## テーブル名・カラム名のエスケープ処理

設計としてはあまり宜しくありませんが， **「ユーザーに任意のテーブル名やカラム名を指定させたい」** というケースも考えられなくはないです．PDOクラスにこういったものをエスケープする機能は含まれていないので，自前でエスケープを行わなければなりません．

- NULLバイトを除外する．
- バッククオートを<ins>2つ連ねて</ins>エスケープさせる．
- 最終的にバッククオートでくくる．

```php:テーブル名をエスケープして動的に指定する例
$sql = sprintf(
"CREATE TABLE `%s`(id int, name text)",
str_replace(["\0", "`"], ["", "``"], $table_name)
);
```

## PDOクラスの継承

- [Qiita - PDOでオブジェクトをフェッチ＆JSONとCSVファイル出力](http://qiita.com/k-holy/items/ce829a60cafe48bd1f81)
- [Architect Note - PDOの真の力を開放する - PHPでデータベースを扱う(3)](http://blog.tojiru.net/article/277021312.html)

-----
-----

# 付録

## 初心者がやりがちなミスの解説

### `mysql_query` などの非推奨関数を利用している

```php
$link = mysql_connect('localhost', 'root', 'password');
mysql_select_db('test');
$result = mysql_query('SELECT * FROM users');
$rows = [];
while ($row = mysql_fetch_assoc($result)) {
$rows[] = $row;
}
```

あなたが参考にしている情報は古すぎます． `mysql_` で始まる関数は，PHP5.5で非推奨になり，PHP7.0で完全に削除されて使えなくなっています．この記事で解説しているように，PDOを使う方法を覚えてください．

### `SET NAMES` あるいは `SET CHARACTER SET` などで文字コードを指定している<br>そもそもデータベースで使用する文字コードの指定をしていない

文字コードの指定が無いのは論外として，`SET NAMES`などを用いるのは可能な限り避けるべきです．このクエリは，データベース側の文字セットを操作するだけで，PDOドライバの文字セットにはノータッチです．入力側と出力側で文字セットが異なると，脆弱性が発生する原因になります．

- 文字コードの性質上， `SET NAMES sjis` や `SET CHARACTER SET sjis` とした場合，顕著に脆弱性が現れる．
- `SET NAMES utf8` や `SET CHARACTER SET utf8` は基本的には安全だが，例外もあるので注意． MySQLにおいては，libmysqlclientのコンパイルオプションに `--with-charset=cp932` や `--with-charset=sjis` を指定している場合が該当． mysqlndを利用している場合は問題ない．
- [へぼい日記 - libmysqlclientを使うプログラムはset namesをutf8であっても使ってはいけない](http://blog.everqueue.com/chiba/2009/02/05/129/)

PDOクラスでの正しい指定方法は，以下のようになります．

- コンストラクタの [DSN(Data Source Name)](http://www.php.net/manual/ja/ref.pdo-mysql.connection.php) で指定する．

```php
$pdo = new PDO('mysql:dbname=test;host=localhost;charset=utf8');
```

- PHP5.3.5以前のPDOではDSNで文字セット指定が出来ないため， `SET NAMES` や `SET CHARACTER SET` に頼らざるを得ない．但しLinux版では，cnfファイルを利用する選択肢がある．
- [Qiita - PHP 5.3.6より前のバージョンの PDO MySQL で charset を指定する](http://qiita.com/ngyuki/items/d88a4df860abb51eb714)
- PHP5.3.6Windows版のPDOではDSNで文字セット指定が出来るが，バグがあるため， `SET NAMES utf8` や `SET CHARACTER SET utf8` を使う場合と同じ結果になる．
- やむを得ず `SET NAMES` を使うにしても， `SET CHARACTER SET` は避けるべき．
- [MySQLマニュアル - SET NAMES と SET CHARACTER SET の違い](http://dev.mysql.com/doc/refman/4.1/ja/charset-connection.html)

MySQL以外では以下のようになります．

- PostgreSQLでは，DSNに `options='--client_encoding=UTF8'"` を含める．
- SQLiteでは特に指定する必要が無く，暗黙的にUTF-8が使用される．

### **`"SELECT * FROM users WHERE id = '$id'"` のように変数展開を使ってSQL文を組み立てている**

Wikipediaを読むのがてっとり早いです．

- [Wikipedia - SQLインジェクション](http://ja.wikipedia.org/wiki/SQL%E3%82%A4%E3%83%B3%E3%82%B8%E3%82%A7%E3%82%AF%E3%82%B7%E3%83%A7%E3%83%B3)

```php
$id = $_POST['id'];
$sql = "SELECT * FROM users WHERE id = '$id'";
```

このようなコードは， **SQLインジェクション攻撃** の格好の標的になってしまうどころか，それを意図せずとも `'` を含めたクエリで検索を行おうとしたときにも正常な処理が行えなくなってしまいます．これを防ぐために，SQL文中で特別な意味を持つ`'`をエスケープし，`\'`に変換する必要があります．

[mysql_query] 関数を使っていた頃は，以下のような手段でSQL文を組み立てるのが主流でした．

1. [mysql_real_escape_string] 関数で文字列をあらかじめエスケープする
2. 変数展開して埋め込む

```php
$id = mysql_real_escape_string($_POST['id']);
$sql = "SELECT * FROM users WHERE id = '$id'";
```

但し，もしこの2行の間にたくさんのコードが入っていたらどうでしょうか？

- あなたは `$id` がエスケープ済みかそうでないか， `$sql` を書くところまでしっかり覚えていられますか？
- 「エスケープ忘れ」「多重エスケープ」という人為的なミスを生んでしまうリスクはないでしょうか？

また，手動エスケープにはこんな罠もあります．

- [htmlspecialchars] 関数は **「HTMLの特殊文字」** をエスケープする関数であり， **「SQLの特殊文字」** をエスケープする関数ではない．全く目的が異なる上に，これを通してしまうとHTML特殊文字をデータベースにそのまま格納できないというバグも発生してしまう．
- [addslashes] 関数は一応それっぽくSQL文に対してエスケープが行えるが，本当にそれがデータベースに合わせて正しくエスケープされているかどうかの保証は無い．マニュアルにもそういった注意書きがある．**例えばSQLiteは`'`を`\'`ではなく`''`にエスケープしなければならない．**

PDOを使う方法では，このようなリスクから開放されます．PDOには，**「プリペアドステートメント」**および**「プレースホルダ」**という仕組みが取り入れられています．詳細については本文中で紹介しているので，付録から戻って読んでみてください．

```php
$id = $_POST['id'];
$stmt = $pdo->prepare("SELECT * FROM users WHERE id = ?");
$stmt->bindValue(1, $id, PDO::PARAM_STR);
```

### `$_POST['id']` などの外部入力からきた変数が定義されているかどうか確認していない<br>それらが文字列であるかどうかの確認をしていない<br>**それらを出力する際に `htmlspecialchars` 関数を利用していない**

以下の記事をお読みください．

- [Qiita - $_GET, $_POSTなどを受け取る際の処理](http://qiita.com/mpyw/items/2f9955db1c02eeef43ea)

別の場所でも指摘していますが，ただ思考停止して [htmlspecialchars] 関数を使えばいいというものでもありません．「<ins>出力する際に</ins>」というのがネックです．例えば以下のコードは間違いです．

```php:データベースに挿入する前にhtmlspecialchars関数を適用している間違った例
$stmt = $pdo->prepare('INSERT INTO users(name) VALUES(?)');
$stmt->bindValue(1, htmlspecialchars($name), PDO::PARAM_STR);
```

### SQLの `LIKE` 演算子を使っているのに `%` `_` `\` のエスケープをしていない

以下のようなコードを書いていたらアウトです．

```php
$stmt = $pdo->prepare("SELECT * FROM users WHERE name LIKE ?");
$stmt->bindValue(1, "%{$name}%", PDO::PARAM_STR);
```

プレースホルダを使っているので脆弱性こそありませんが，LIKE演算子による正しい検索が保証されません．正しい実装方法は本文中に記載しています．

### HTMLの `<body></body>` の中にデータベース接続処理を書いている<br>`echo()` や `print()` をベタ書きしている<br>Content-Typeを `text/plain` に変更せずに `exit()` や `die()` で強制終了処理を記述している

以下のようなコードを書いていたらアウトです．

```html+php
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>Example</title>
</head>
<body>
<ul>
<?php

try {

$pdo = new PDO('mysql: ... ', 'root', 'password', [
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
]);
$stmt = $pdo->query('SELECT * FROM users');
while ($row = $stmt->fetch(PDO::FETCH_ASSOC)) {
echo '<li>' . htmlspecialchars($row['name']) . '</li>';
}

} catch (PDOException $e) {

exit($e->getMessage());

}

?>
</ul>
</body>
</html>
```

もし，PDOに接続するところで失敗してしまった場合にどうなるでしょうか？きっと，出力されるHTMLはこんな感じになるはずです．

```html
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>Example</title>
</head>
<body>
<ul>No such file or directory
```

もし，あなたがこんな壊れたHTMLをWebサイト利用者に見られて恥も何も感じないのであれば私は止めませんが，多くの人は気にすると思います．…というよりも，まずこのコードは非常に読みにくいので**「ロジックとテンプレートの分離」**は行いましょう．

- 頭のほうですべてのロジックを書き，そこを過ぎたら<ins>用意された変数を使ってHTMLを出力する以外のことは行ってはいけません</ins>． （理想を言えば，ファイルも分けるべき）
- 広々と確保した `<?php ... ?>` 中で [echo] や [print] を連呼してHTMLを生成するのは，初心者が陥りやすい典型的な間違ったPHPの使い方です．PHPはこれでも**テンプレートエンジン**的な役割を持つ言語なので，上記で指摘したロジックとテンプレートの分離を行った後は，<ins>PHPの中にHTMLを埋め込むのではなく，**HTMLの中にPHPを埋め込む**感覚で書きましょう</ins>．

上記2点に関して，以下に修正した例を示します．

```html+php
<?php

try {

$pdo = new PDO('mysql: ... ', 'root', 'password', [
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
]);
$rows = $pdo->query('SELECT * FROM users')->fetchAll(PDO::FETCH_ASSOC);

} catch (PDOException $e) {

exit($e->getMessage());

}

function h($str)
{
return htmlspecialchars($str, ENT_QUOTES, 'UTF-8');
}

?>
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>Example</title>
</head>
<body>
<ul>
<?php foreach ($rows as $row): ?>
<li><?=h($row)?></li>
<?php endforeach; ?>
</ul>
</body>
</html>
```

**[echo]短縮構文** および **[制御構造に関する別の構文](http://php.net/manual/ja/control-structures.alternative-syntax.php)** を用いてみました．この2つはHTMLを出力する際に適用するとコードが非常に読みやすくなります．これで，エラー時に出力されるHTMLは以下のようになります．

```html
No such file or directory
```

ただ，これってもはやHTMLではないですよね？もしエラー時にも丁寧にエラー画面用のHTMLを用意するのであればそれで構わないのですが， [exit] や [die] で手抜きしたい場合はWebブラウザに**「これはただのテキストです」**と伝えるようにしましょう． [exit] の前にこの1行を入れてください．

```php
header('Content-Type: text/plain; charset=UTF-8', true, 500);
```

500は「500 Internal Server Error」の意味で，サーバ側が原因でエラーになってしまったことを表します．

## PDOとmysqliの比較

### [mysqliクラス (またはmysqli関数)](http://www.php.net/manual/ja/book.mysqli.php)

手続き型(関数)とオブジェクト指向型(クラス)を両方ともサポートしています．

#### <font color="silver">メリット</font>

- 動作が **非常に** 速い．
- (手続き型の場合は) mysql関数からの書き換えが容易．
- プリペアドステートメントで型を指定しながら複数のバインドが同時に **できる** ．
- **マルチクエリ** を使用できる．1回の関数コールで複数のクエリが実行できるため，普通に2回コールする場合に比べてパフォーマンスは向上する．
- エラーを例外としてスローさせることができる．2種類の設定方法があるが，これに関しては<ins>他の記述がオブジェクト指向型でも手続き型を採用すべき</ins>であると言える．明らかに手続き型の方がスッキリと書ける．

```php:オブジェクト指向型
$driver = new mysqli_driver();
$driver->report_mode = MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT;
```

```php:手続き型
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
```

- 不適切なインデックスを含むクエリに対しても，例外をスローさせることができる．開発段階でデータベースに負荷をかけてしまうクエリを潰すことが出来る利点がある．これを有効化するためには，下記のようにする． `MYSQLI_REPORT_ALL` でまとめる手もある．

```php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT | MYSQLI_REPORT_INDEX);
```

```php
mysqli_report(MYSQLI_REPORT_ALL);
```

- [久保清隆の成長ノート - MySQLパフォーマンスチューニングのためのインデックスの基礎知識](http://d.hatena.ne.jp/kiyo560808/20101117/1289952549)

#### <font color="silver">デメリット</font>

- プリペアドステートメントで名前付きプレースホルダが **使えない** ．
- **「プリペアドステートメント ≠ 結果セット」** であり，SQL実行後にプリペアドステートメントから結果セットを取り出す必要がある．この点は次に紹介するPDOクラスと大きく異なる．
- その他の点でも多機能すぎる為，初心者が混乱しやすい．

### [PDOクラス](http://php.net/manual/ja/book.pdo.php)

オブジェクト指向型のみをサポートしています．

#### <font color="silver">メリット</font>

- 動作が速い．
- エラーを例外としてスローさせることが出来る．但し，一部の特例を除き，<ins>コンストラクタは常に例外をスローする</ins>．

```php:PDOクラスで例外をスローさせる
$pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
```

- **「プリペアドステートメント ＝ 結果セット」** であり，mysqliクラスに比べると初心者にも分かりやすい．
- プリペアドステートメントで名前付きプレースホルダが **使える** ．
- プリペアドステートメントのエミュレーションを行う場合は **同名の名前付きプレースホルダを複数回使える** ．但し，エミュレーションを設定していないと `SQLSTATE[HY093]: Invalid parameter number` が発生する．
- 他のデータベースへ乗り換える際，書き換えが容易．PDOクラスの使い方だけを覚えておけばドライバが存在するあらゆるデータベースに対応が出来るようになる．

#### <font color="silver">デメリット</font>

- プリペアドステートメントで型を指定しながら複数のバインドが同時に **できない** ．
- `SET NAMES sjis` や `SET CHARACTER SET sjis` を設定している場合，プリペアドステートメントのエミュレーションを無効にしておかないと脆弱性が発生する．
- プリペアドステートメントのエミュレーションを行う場合は [PDOStatement::bindValue], [PDOStatement::bindParam] メソッドで，<ins>指定した型と実際の型が一致しない場合，全て文字列としてバインドされる</ins>．

[PEAR::DB](http://pear.php.net/manual/ja/package.database.db.php) や [PEAR::MDB2](http://pear.php.net/manual/ja/package.database.mdb2.php) に関しては,PDOが安定してきたPHP5.4系以降で使う必要性は皆無でしょう．PHPで実装された抽象化レイヤは，C言語で実装されたPDOよりも明らかにパフォーマンスが悪くなります．

- [\[Z\]ZAPAブロ～グ2.0 - PDO，PEAR::DB，Mysql関数の速度比較](http://zapanet.info/blog/item/972)

[mysql_query]: http://php.net/manual/ja/function.mysql-query.php
[mysql_real_escape_string]: http://php.net/manual/ja/function.mysql-real-escape-string.php
[htmlspecialchars]: http://www.php.net/manual/ja/function.htmlspecialchars.php
[addslashes]: http://www.php.net/manual/ja/function.addslashes.php
[exit]: http://www.php.net/manual/ja/function.exit.php
[die]: http://www.php.net/manual/ja/function.die.php
[PDO::__construct]: http://php.net/manual/ja/pdo.construct.php
[PDO::setAttribute]: http://www.php.net/manual/ja/pdo.setattribute.php
[PDOStatement::execute]: http://www.php.net/manual/ja/pdostatement.execute.php
[PDOStatement::fetch]: http://www.php.net/manual/ja/pdostatement.fetch.php
[PDOStatement::fetchAll]: http://www.php.net/manual/ja/pdostatement.fetchall.php
[PDOStatement::bindValue]: http://www.php.net/manual/ja/pdostatement.bindvalue.php
[PDOStatement::bindParam]: http://www.php.net/manual/ja/pdostatement.bindparam.php
[PDO::query]: http://www.php.net/manual/ja/pdo.query.php
[PDOStatement::rowCount]: http://www.php.net/manual/ja/pdostatement.rowcount.php
[PDO::exec]: http://www.php.net/manual/ja/pdo.exec.php
[PDO::prepare]: http://www.php.net/manual/ja/pdo.prepare.php
[PDOStatement::bindParam]: http://www.php.net/manual/ja/pdostatement.bindparam.php
[count]: http://www.php.net/manual/ja/function.count.php
[PDOStatement::fetchColumn]: http://www.php.net/manual/ja/pdostatement.fetchcolumn.php
[PDOStatement::closeCursor]: http://www.php.net/manual/ja/pdostatement.closecursor.php
[echo]: http://www.php.net/manual/ja/function.echo.php
[print]: http://www.php.net/manual/ja/function.print.php

<del datetime="2017-05-11T20:45:00+09:00">この記事は[CC BY 3.0](http://creativecommons.org/licenses/by/3.0/)に基いて公開されてゐるWebサイト[Choosing an OSS license doesn’t need to be scary - ChooseALicense.com](http://choosealicense.com/)のコンテンツ各ページを翻訳し、単一記事として再構成、訳者による補足を追加したものです</del>。

<div class="alert alert-warning"><ins datetime="2017-05-09T20:45:00+09:00"><time datetime="2017-05-11T01:27:00+09:00">2017年5月9日</time>に<a href="http://blog.qiita.com/post/160423117339/communityguideline">開示</a>された<a href="http://help.qiita.com/ja/articles/qiita-community-guideline">コミュニティガイドライン</a>に伴って、本記事の翻訳部分につきましては削除いたしました。 (この記事が削除または非公開化されない限り、<a href="http://qiita.com/tadsan/items/99d816e78ca429093b75/revisions">編集履歴</a>からお読みいただくことは可能です。)</ins></div>

<div class="alert alert-info">日本語での自由ソフトウェア/オープンソースライセンスについての紹介については、<a href="http://www.catch.jp/">可知豊</a>(@<a href="https://twitter.com/y_catch">y_catch</a>)先生の<a href="http://www.catch.jp/oss-license/2013/09/10/github/">Githubによる、オープンソースライセンスの選び方 | オープンソース・ライセンスの談話室</a>をオススメします。</div>

*(訳註: この「はじめに」及び末尾の「訳者による補足」の章は原文にはなく、翻訳者(@tadsan)によるものです。記事の著作権表示及び元Webサイトの利用規約、免責事項、そしてこの記事についての訳者の見解について記します)*

<a rel="license" href="http://creativecommons.org/licenses/by/3.0/"><img alt="Creative Commons Attribution-ShareAlike 3.0 Unported License" style="border-width:0" src="https://qiita-image-store.s3.amazonaws.com/0/4121/b660c4a4-3d55-e6d6-4108-0a6939ea7aee.png" /></a>

(この記事の一部または全て ——ただしコメント欄は含まれない—— はCC BY-SA 3.0に則る限り、自由に利用することができます。<del datetime="2017-05-11T20:25:00+09:00">翻訳と「はじめに」「訳註」については独自の著作権は主張しません。</del> 改竄しても二次利用は独自の責任にて行ってください。)

> Please consult a legal expert before adopting a software license for your project.
> This site is licensed under the Creative Commons Attribution 3.0 Unported License.
>
> Demystified with <3 by GitHub, Inc.

元サイトには利用規約として[Terms of Service - ChooseALicense.com](http://choosealicense.com/terms-of-service/)が存在します。この利用規約の有効性及び有効範囲について、訳者(@tadsan)は **言及しません**。参考として、見出しのみを抜萃し、()内に訳者による参考訳を補ひました。

> ### [Terms of Service - ChooseALicense.com](http://choosealicense.com/terms-of-service/)
> 1. Introduction (はじめに)
> 2. Agreement to the Terms (規約に同意すること)
> 3. No legal advice is being provided (法的な助言をするものではない)
> 4. DISCLAIMER OF WARRANTIES (保証の抛棄)
> 5. LIMITATION OF LIABILITY (責任の制限)
> 6. Indemnification for breach of the Terms (規約違反の補償)
> 7. Termination of this Agreement (契約の終了)
> 8. Miscellaneous Terms (雑則)

この記事において「ライセンス」とは、特に断りのない限りはフリーソフトウェア(自由ソフトウェア)・オープンソースライセンスと呼ばれる形態のライセンスのことです([FLOSS - Wikipedia](https://ja.wikipedia.org/wiki/FLOSS))。

もとのWebサイト([creativecommons.org](http://creativecommons.org))及びこの翻訳記事は、あなたに **法的な助言** を与へるものではありません。ライセンス問題及び各ライセンスが日本及び外国の法律・条約・条例に基いて有効・適法な契約であるかについては、必ず弁護士などの法律専門家の判断を仰いでください。上記の "Term of Service" の解釈についても同様とします。

翻訳は直訳よりは日本語として解釈しやすいように意訳してあります。原文との見解の相違がないように注意して訳しますが、英語及びライセンスへの認識の差により、原文と矛盾した意味になってしまってゐるリスクもあります。 *(訳註:* から始まる文章は、訳者(@tadsan)が **独自の見解により** 本文の内容を註釈・補足するものです。

筆者は翻訳及び訳註により原文と異った意味に改変することを望まないので、もし誤訳及びライセンス見解の誤り、その他ミスなどを発見した場合には訳者(@tadsan)にコメントなどでフィードバックをいただけると幸ひです。

翻訳にあたって法律の専門家や法律智識を持った翻訳家の助言を受けたものではありません。また、この記事はあくまでライセンス原文を解釈し、要約を試みたものなので、優先されるべきは常に原文です。 *(本記事のみならず、ほかの翻訳・ライセンス解説についても同様に解釈するべきです)*

繰り返しますが、この記事は専門家による法律判断ではありません。法律問題への対処には専門家によるアドバイスを受けてください。元サイト及び本記事を参考にしたことで受けた全ての利益・損害について、原著者及び翻訳者は一切の権利・責任を負ひません。

*(以下より記事本文です)*

-----

[Choose an open source license (choosealicense.com)](https://choosealicense.com/)をお読みください。

[](https://qiita-image-store.s3.amazonaws.com/0/4121/2aa5eda8-c273-9d9f-df07-b2b2500bc78a.png)

<ins datetime="2017-05-09T20:45:00+09:00">(日本語訳文は削除されました。原文または「<a href="http://www.catch.jp/oss-license/2013/09/10/github/">Githubによる、オープンソースライセンスの選び方</a>」をお読みください。</ins>

-----

*(翻訳による内容は、ここまで)*

訳者による補足
--------------

### 補足1. ライセンスを宣言する方法

最善の方法はソースコードすべてにライセンスを明示することです。

そして、`README` などと同じディレクトリに `LICENSE.txt` または `COPYING` などのファイルを用意して、そこにライセンスの本文や要約をコピーします。

ライセンスの本文の上部に `Copyright (c) [year] [fullname]` のような形式の穴埋めテンプレートがある場合は、そこ「だけ」を現在の年と自分の名前に変更します。いくつかのライセンスは、本文を「改変しない限り再配布して良い」と許諾してゐること、そして不用意に本文を変更したり条件を追加することで利用者に混乱をきたすことがその理由です。

GitHubではリポジトリ作成時にライセンスを選択して、自動で作成させることもできます([Open source licensing · GitHub Help](https://help.github.com/articles/open-source-licensing))。

ただし、Webで使用されるJavaScriptなどファイル単位で読み込まれる場合、当然ながら `README` や `LICENSE` などのテキストファイルは添付しにくくなります。参考までに、そのような場合のライセンス表示のサンプルを紹介します。

[prototype.js](https://ajax.googleapis.com/ajax/libs/prototype/1.7.1.0/prototype.js)の先頭には以下の記述があります。

```prototype.js
/* Prototype JavaScript framework, version 1.7.1
* (c) 2005-2010 Sam Stephenson
*
* Prototype is freely distributable under the terms of an MIT-style license.
* For details, see the Prototype web site: http://www.prototypejs.org/
*
*--------------------------------------------------------------------------*/
```

また、jQuery の場合はもっと簡潔です。 ([jquery-2.0.3.min.js](http://code.jquery.com/jquery-2.0.3.min.js))

```jquery-2.0.3.min.js
/*! jQuery v2.0.3 | (c) 2005, 2013 jQuery Foundation, Inc. | jquery.org/license
*/
```

どちらの場合にも著作権表示があり、前者はライセンス名で表記、後者はライセンスを明記したページのURLへ誘導してゐることが特徴的です。

### 補足2. マルチライセンス

PerlはArtistic Licenseで公開されてゐると上記にありますが、実際には [Perl Licensing - dev.perl.org](http://dev.perl.org/licenses/) 及び配布パッケージ内の `README` 内には以下の記述があります。

> Perl5 is Copyright (C) 1993-2005, by Larry Wall and others.
>
> It is free software; you can redistribute it and/or modify it under the terms of either:
>
> * a) the [GNU General Public License](http://dev.perl.org/licenses/gpl1.html) as published by the [Free Software Foundation; either](http://www.fsf.org/) [1](http://dev.perl.org/licenses/gpl1.html), or (at your option) any [later version](http://www.fsf.org/licenses/licenses.html#GNUGPL), or
> * b) the "Artistic License".

*—— http://dev.perl.org/licenses/ より引用 (2013年9月7日 閲覧)*

これは、ライセンスとして「GPLv1(または任意に指定された番号)以上のバージョン」または「Artistic License」のうちの **どれか** の条件に従へば良いといふことになります。このような状態を「マルチライセンス」と呼びます(この場合は2つなので「デュアルライセンス」、3つなら「トリプルライセンス」とも呼ばれます)。

このマルチライセンスに含めるライセンスは必ずしもフリーソフトウェアライセンスである必要はなく、金銭を対価にサービスを提供するような商業契約(コマーシャルライセンス)であることもあります。[MySQL](https://ja.wikipedia.org/wiki/MySQL#.E3.83.A9.E3.82.A4.E3.82.BB.E3.83.B3.E3.82.B9)がこの形態のソフトウェアの代表例です。

### 補足3. ライセンスを明示しないこと

サイボウズ・ラボの西尾泰和さんのことばに次のようなものがあります。

> 著作権を主張しないつもりなんだったらそれを明示的に宣言して欲しい。ライセンスが明示されていないのは、どんなライセンスよりも厳しいライセンスだ。

*([Ruby 1.9.2リリースとWEBrick脆弱性問題の顛末 - 西尾泰和のはてなダイアリー](http://d.hatena.ne.jp/nishiohirokazu/20100819/1282200581) より引用)*

また、2chの [Navi2ch for Emacs (Part 20)](http://toro.2ch.net/test/read.cgi/unix/1265413075/) スレのテンプレには次のようなFAQがあります。

> Q. パッチを作ったんだけど、ここに up すれば良いの？
> A. 2ch で晒すと取り込めなくなるので、sourceforge に投げてね。
> ttp://sourceforge.net/tracker/?atid=435774&group_id=39552&func=browse
>
> Q. 自作の関数や設定を晒したいんだけど、どうすれば良い？
> A. 設定はともかく、関数を 2ch で晒すのは NG。
> navi2ch に取り込んで欲しいなら、上記にパッチを投げてね。
> ただ晒したいだけなら、メーリングリストやグループに投げてね。

*(http://toro.2ch.net/test/read.cgi/unix/1265413075/2 より引用)*

匿名でライセンスを明示しないソースコードを公開するリスクは本文中に訳註として書いた通りです。特に2chでは後から作者を特定することができず、よってライセンスを変更することも不可能になり、合法的に二次利用することができなくなります。

### 補足4. より信頼のおける情報源

もっと基礎から詳しくライセンスについて学びたいのでしたら、有料(800円)の電子書籍ですが、「[知る、読む、使う！ オープンソースライセンス](http://tatsu-zine.com/books/osslicense)」が良いかもしれません。(実は訳者はまだ読んでゐません!)

もっと深くライセンスについて理解するための資料としては、IPA(独立行政法人 情報処理推進機構)のWebサイトに[OSSライセンス関連情報](http://www.ipa.go.jp/osc/osslegal.html)として、多数まとめられてゐます。特に[GNU GPL v3 逐条解説書](http://ossipedia.ipa.go.jp/doc/187/)は非常に詳細なレポートで、[SFLC](http://ja.wikipedia.org/wiki/Software_Freedom_Law_Center)の協力を受けてまとめられた、極めて信頼度の高いものです。さらにこのレポートは[Creative Commons 表示 - 非営利 - 改変禁止 2.1 日本(CC BY-NC-ND 2.1 JP)](http://creativecommons.org/licenses/by-nc-nd/2.1/jp/)として利用可能です。

### 補足5. ライセンスの互換性

*(この話はわかりやすさ重視の例で、技術的な正確性はありません)*

突然ですが、あなたは画像ブラウザを作りました。これは、[BMP形式](https://ja.wikipedia.org/wiki/Windows%E3%83%93%E3%83%83%E3%83%88%E3%83%9E%E3%83%83%E3%83%97)の画像をとても快適に管理できる、べんりなアプリケーションです *(言語は何でも良いですが、[Delphi](https://ja.wikipedia.org/wiki/Delphi)でネイティブコードにコンパイルしたとします)*。

ある日、あなたは気がつきました。「画像をBMP形式に変換して読み込めば、どんな形式の画像でもサポートできるぞ!」と。

あなたが最初に見付けたのは、JPEG画像をBMPに変換するライブラリでした。これは一切著作権を主張しないことが宣言された、パブリックライセンスのライブラリでした。このソースコードを使って、あなたのアプリケーションはJPEG対応になりました。

<dl><dt>Q.</dt><dd>このアプリケーションのソースコードを公開する必要はありますか?</dd><dt>A.</dt><dd>公開義務はありません。なぜなら、著作権はわたしが持ってゐるからです。また、JPEGライブラリには著作権は<em>ありませんでした。</em></dd></dl>

次に見付けたのは、John Smithさんが作った、PNG画像をBMPに変換するライブラリでした。これは2条項BSDライセンスでした。このライブラリを静的リンクすることで、あなたのアプリケーションはPNG形式対応になりました。

<dl><dt>Q.</dt><dd>このアプリケーションのソースコードを公開する必要はありますか?</dd><dt>A.</dt><dd>公開義務はありません。なぜなら、わたしが著作権を持つコードと、2条項BSDライセンスのコードから構成されるからです。</dd><dt>Q.</dt><dd>あなたは何をしなければなりませんか?</dd><dt>A.</dt><dd>ドキュメントにPNGライブラリの作者名とライセンスを明記することです。わたしは<code>README</code>ファイルに<strong>License</strong>の章を設け、次のように追記しました。</dd></dl>

> ## License
> ### HogePngLibrary
>> (C) Copyright 2001 John Smith
>>
>> All rights reserved.
>>
>> Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
>>
>> * Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
>> * Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
> * Neither the name of the <ORGANIZATION> nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
>>
>> THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

<!--
次にあなたは、JPEG2000形式の画像をBMP形式に変換するライブラリを見付けました。
-->

# 本家サイトと日本語訳サイト
## [本家サイト](http://golang.org/)
標準ライブラリの使い方はここを見ればよい。
APIドキュメントからソースが簡単に見れるので、勉強になる。

## [Go Wiki](https://github.com/golang/go/wiki)
[SliceTrics](https://github.com/golang/go/wiki/SliceTricks)など，初心者向けの情報があるのでチェックするとよい．少し情報が古いところもある。

## [golang-jp.org](http://golang-jp.org/)
本家サイトを日本語に翻訳しているサイト．情報は新しいが，一部未翻訳の箇所あり．翻訳プロジェクトはgithubで管理されているので，翻訳に[協力](https://github.com/gophersjp/go/wiki/%E7%BF%BB%E8%A8%B3%E5%8D%94%E5%8A%9B%E3%83%95%E3%83%AD%E3%83%BC)もできる．

# 入門

## [A Tour of Go](http://go-tour-jp.appspot.com/#1)
A Tour of Goの日本語版。Go言語の機能の説明を一通り網羅している。練習問題が若干初心者には厳しい（ニュートン法とか）。
追記：英語版は改定されてて，取っ付きにくい練習問題はなくなっているらしい。

## [Whispering Gophers](http://whispering-gophers.appspot.com/talk.slide#1)
チャットアプリを作る順々に作っていけるサンプル．channelやgoroutineについて学べる．
リポジトリ：https://code.google.com/p/whispering-gophers/

## [はじめてのGo](http://gihyo.jp/dev/feature/01/go_4beginners)
Jxckさんの入門記事です。非常に分かりやすいので，入門としておすすめ。

## [Go Web プログラミング](http://astaxie.gitbooks.io/build-web-application-with-golang/content/ja/index.html)
astaxieさんのGoによるWebプログラミング入門の日本語訳です。

# よいコードを書くために見た方がよさそうなところ

## [Go Proverbs](https://go-proverbs.github.io/)
Rob Pike氏のGoの格言をまとめたサイト。Gophers Slackのロード画面にも出てくる。

## [Go Code Review Comments](https://github.com/golang/go/wiki/CodeReviewComments)（[日本語訳](http://qiita.com/knsh14/items/8b73b31822c109d4c497))
Goのコードを書く上で、気をつけることがまとめられているサイト。公式ドキュメントの[Effective Go](https://golang.org/doc/effective_go.html)をまとめたものが多い。

# コミュニティ

## [golang-nuts](https://groups.google.com/forum/#!forum/golang-nuts)
Google Groups上のグループ。Go言語の情報はここにほとんど集まっている。但し英語。

## [Go+](https://plus.google.com/communities/114112804251407510571)
英語のGoogle+上のコミュニティ。golang-nutsよりは情報が少ないが、Google+上なので情報をキャッチしやすい。

## [Golang JP(Google+)](https://plus.google.com/communities/107075098212007233819)
Google+上の日本のGo言語コミュニティ。日本語なので、質問しやすい。日本のGo言語のイベントの情報等もここに流れる。

##[Lingr-Go言語](http://lingr.com/room/golang)
Go言語の話題を話すチャットルーム。
リアルタイムで聞けます！

## [Slack-Gophers](http://blog.gopheracademy.com/gophers-slack-community/)
Slackのコミュニティです。`#japan`や`#tokyo`には日本の方がいるので，日本語で質問しやすい。この他にも分野や地域ごとに部屋があるので，いろいろ部屋を見るとよい。

# ドキュメントやまとめサイト

## [Go Search](http://go-search.org/)
Go言語のライブラリを探せる．検索結果にgodoc.orgやGo Walkerへのリンクがある．
どういうライブラリがよく利用されているかわかるので便利．

## [godoc.org](http://godoc.org/)
様々なGo言語のライブラリのAPIドキュメントを生成するサービス。
URLの後ろにライブラリのインポートパスを入れると自動でAPIドキュメントが生成、公開される。トップページのPopular Packagesを眺めるだけで、人気のパッケージが分かる。

## [Go Walker](https://gowalker.org/)
APIドキュメントを生成するサービス．個人的には，godoc.orgより使いやすい．

## [golang-samples](https://github.com/golang-samples)
Go言語のサンプルを集めたGithubのOrganization。誰でも参加して、新しいレポジトリを追加できる。参加したければ、golang.samples@gmail.com にメールを送れば良い。pull requestを送るだけでもよい。

## [goz](http://goz.hexacosa.net/)
Go言語の熱い記事をチェックできるサイト．

## [Go by Example](https://gobyexample.com/)（[日本語訳](https://oohira.github.io/gobyexample-jp/)）
豊富なサンプルを見つけることができるサイト．

## [Go Tutorial: Dot Net Perls](http://www.dotnetperls.com/go)
基本的な機能を具体的な例と実行結果を提示しているサイト．
`regexp`パッケージや`strings`パッケージのサンプルがあって分かりやすい．

# 便利サイト，便利ツール
## [Go Playground](http://play.golang.org/)
Web上でGo言語を実行できるサイト。Go言語をインストールする前にここで試してみるといいかもしれない。

## [goenv](https://bitbucket.org/ymotongpoo/goenv)
プロジェクトごとにGOPATHを設定できるツール．

## [Dash](https://itunes.apple.com/us/app/dash-docs-snippets/id458034879?mt=12)
色々な言語のドキュメントをすばやく閲覧したり、スニペットを登録できるMacのアプリ。Go言語のドキュメントもある。

## [お気楽 Go 言語プログラミング入門](http://www.geocities.jp/m_hiroi/golang/index.html)
Go言語の文法や演習問題など網羅的に解説してあるサイト。

# 環境構築・エディタの使い方
* vim : [Vimを使ったGo言語開発手法](http://mattn.kaoriya.net/software/vim/20130531000559.htm)
* Emacs : [Emacsを使ったGo言語開発手法（2013.07版）](http://ymotongpoo.hatenablog.com/entry/2013/07/06/154448)
* LiteIDE: [go言語の始め方(1)](http://python.matrix.jp/2013/05/09/go_start1.html)

#書籍
参考：https://github.com/golang/go/wiki/Books#japanese

* [はじめての「Go言語」](http://www.amazon.co.jp/%E3%81%AF%E3%81%98%E3%82%81%E3%81%A6%E3%81%AE%E3%80%8CGo%E8%A8%80%E8%AA%9E%E3%80%8D-I%E3%83%BBO-BOOKS-%E8%8C%A8%E6%9C%A8-%E9%9A%86%E5%BD%B0/dp/4777515591)
* [Go言語プログラミング入門on Google App Engine](http://www.amazon.co.jp/Go%E8%A8%80%E8%AA%9E%E3%83%97%E3%83%AD%E3%82%B0%E3%83%A9%E3%83%9F%E3%83%B3%E3%82%B0%E5%85%A5%E9%96%80on-Google-App-Engine-%E6%A8%AA%E5%B1%B1/dp/4798031801)
* [はじめてのGoogle App Engine Go言語編](http://www.amazon.co.jp/%E3%81%AF%E3%81%98%E3%82%81%E3%81%A6%E3%81%AEGoogle-App-Engine-Go%E8%A8%80%E8%AA%9E%E7%B7%A8-BOOKS/dp/4777516601)
* [プログラミング言語Goフレーズブック](http://www.amazon.co.jp/%E3%83%97%E3%83%AD%E3%82%B0%E3%83%A9%E3%83%9F%E3%83%B3%E3%82%B0%E8%A8%80%E8%AA%9EGo%E3%83%95%E3%83%AC%E3%83%BC%E3%82%BA%E3%83%96%E3%83%83%E3%82%AF-David-Chisnall/dp/486401096X)
* [基礎からわかる Go言語](http://www.amazon.co.jp/%E5%9F%BA%E7%A4%8E%E3%81%8B%E3%82%89%E3%82%8F%E3%81%8B%E3%82%8B-Go%E8%A8%80%E8%AA%9E-%E5%8F%A4%E5%B7%9D-%E6%98%87/dp/4863541171)（[改訂2版](http://www.c-r.com/book/detail/1018)）
* [An Introduction to Programming in Go](http://www.golang-book.com/)
* [プログラミング言語Go](https://www.amazon.co.jp/%E3%83%97%E3%83%AD%E3%82%B0%E3%83%A9%E3%83%9F%E3%83%B3%E3%82%B0%E8%A8%80%E8%AA%9EGo-ADDISON-WESLEY-PROFESSIONAL-COMPUTING-Donovan/dp/4621300253)

#これからiOSアプリ開発をやりたい！という人へ
自分が実際にiOSアプリ開発をやって、便利だったと思う情報を残しておきます。
これからアプリ開発やりたいという人の参考になれば。


##iOSアプリ開発の第一歩
まずは間違いなくMacを買うこと。
Macを書いましょう。Windowsじゃ開発できません。
MacじゃないとiOSアプリの開発はできないので、
これがないとお話になりません。。。


##インストールしておくもの
基本的にXcodeさえインストールしておけばアプリの開発はできます。
`Mac App Store`からダウンロードできます。

実機インストールや`App Store`に公開したい場合は、
`iOS Developer Program`を購入する必要があります。

##まずはこれを読むべき
Appleのドキュメント集（日本語訳Version）
https://developer.apple.com/jp/devcenter/ios/library/japanese.html
日本語タイトルのリンクを開くと日本語PDFを開けます。

初心者向けの内容から各フレームワークにフォーカスしたドキュメントが置いてあります。
iOSのアーキテクチャについて触れているドキュメントも多いので、これを読んでおけば無敵です。

###まず読むべきモノ
意味がわからなくてもさらっと見ておくと良いと思います。

- iOS ヒューマンインターフェイス ガイドライン（←これ面白い）
- iOS View Controller プログラミングガイド
- iOS Table View プログラミングガイド
- iOS View Controllerカタログ（←これ面白い）

###初心者向け

- 初めての iOS アプリケーション
- 2つ目のiOSアプリケーション:ストーリーボード
- 3つ目のiOSアプリケーション:iCloud


##入門資料

- Mixiの研修資料
https://github.com/mixi-inc/iOSTraining

- ドットインストール
iOSプログラミング入門 (全24回)
http://dotinstall.com/lessons/basic_ios


##よくお世話になったサイト

iPhoneアプリ開発の虎の巻
http://iphone-tora.sakura.ne.jp/

Cocoaの日々
http://cocoadays.blogspot.jp/

強火で進め
http://d.hatena.ne.jp/nakamura001/

Over&Out その後
http://d.hatena.ne.jp/shu223/

iPhone ｜ Developers.IO
http://dev.classmethod.jp/category/iphone/


##便利系ツール

#####AppCode
http://www.jetbrains.com/objc/
jetbrains社が提供しているObjective-C用IDEです。
Storyboardなどを編集する際はXcodeを使わないと編集できませんが、
コードを書くときは圧倒的にこちらのほうが速いです。
補完が優秀であったりリファクタリングが優秀だったりと、
色々機能も豊富なのでストレスも少ないです。
気になる人はぐぐってみてください。
紹介記事も多いようです。

追記：Xcodeとの比較をしている記事があったのでご紹介。
http://developer.smartnews.be/blog/2013/07/16/appcode-increases-objective-c-productivity/

ショートカット集などなど
[AppCodeをInstallして最初にすること＆ショートカット](http://qiita.com/kouchi67/items/defaaba875546210fece)
[AppCodeで知っていると便利なショートカット12選](http://qiita.com/happy_ryo/items/8cf569990eb8f7aa582f)
[AppCodeショートカットメモ（コード補完周り）](http://qiita.com/kouchi67/items/9bff6cd9be2d7070fbdf)

#####Xcodeチートシート
http://www.dotapon.sakura.ne.jp/blog/?p=305
http://devcheatsheet.com/tag/xcode/
効率は正義。
ショートカットを駆使して爆速コーディング！

#####github
https://github.com/
iOSのオープンソースがたくさんあります。
開発者として登録もしておくと良いでしょう。

#####Cocoa Controls
https://www.cocoacontrols.com/
MacやiOSのオープンソース紹介サイト。
スクリーンショット付きで紹介されているので、
目的のモノを探すときに便利です。

#####Cocoapods
http://cocoapods.org/
Objective-Cで書かれたオープンソースのパッケージ管理ソフトです。
基本的にコマンドラインです。
yumとかgemとかに馴染みがある人はとっつきやすいと思います。


----


ひとまず以上です。
個人的にですが、学習する上で大事だと思う事をいくつか紹介。

- ドキュメントを探す／読む
実装したい機能について、Appleからドキュメントが提供されているかどうかくらいは確認しましょう。
あれば読み込みましょう。
下手なブログ読むよりよっぽど確実で詳しいです。

- ショートカットを覚える
効率的に作業するというのは想像以上に大事です。
効率良く開発をすることは、快適でかつストレスが少ないです。
楽しく効率的に開発を続けていくために是非習得しましょう。

頑張って自分のアプリを作れるようになりましょう！


----

#おまけ - 書籍

独断と偏見で良書だと思ってる書籍を紹介。
個人的には初心者向けな書籍とか必要ない気もします。
最近はブログ等も多く、何よりAppleのドキュメントが豊富なので、
基本的にそちらを見て勉強するのが良い気がします。

##[iPhone SDK 3 プログラミング大全 実践プログラミング](http://www.amazon.co.jp/exec/obidos/ASIN/4048679910/22301-22/ref=nosim/)
初めて手にとって読んだ本。
iOSの仕組みについて詳しく解説されていた印象がある。
バージョンは古いけど入門資料としてはまだまだ役立つ書籍かもしれない。

##[iPhoneアプリ開発エキスパートガイド iOS 6対応](http://www.amazon.co.jp/iPhone%E3%82%A2%E3%83%97%E3%83%AA%E9%96%8B%E7%99%BA%E3%82%A8%E3%82%AD%E3%82%B9%E3%83%91%E3%83%BC%E3%83%88%E3%82%AC%E3%82%A4%E3%83%89-iOS-6%E5%AF%BE%E5%BF%9C-%E5%8A%A0%E8%97%A4-%E5%AF%9B%E4%BA%BA/dp/4844333852/ref=pd_sim_b_2)
iOS6から追加された機能を丁寧に紹介している。良書。

##[iOS5プログラミングブック](http://www.amazon.co.jp/iOS5%E3%83%97%E3%83%AD%E3%82%B0%E3%83%A9%E3%83%9F%E3%83%B3%E3%82%B0%E3%83%96%E3%83%83%E3%82%AF-%E5%8A%A0%E8%97%A4-%E5%AF%9B%E4%BA%BA/dp/4844332228)
iOS5から追加された機能を丁寧に紹介している。良書。

##[iOS4プログラミングブック](http://www.amazon.co.jp/iOS4%E3%83%97%E3%83%AD%E3%82%B0%E3%83%A9%E3%83%9F%E3%83%B3%E3%82%B0%E3%83%96%E3%83%83%E3%82%AF-%E7%95%91-%E5%9C%AD%E8%BC%94/dp/4844329766/ref=pd_bxgy_b_img_y)
iOS4から（略

##[iOSアプリ開発達人のレシピ100](http://www.amazon.co.jp/iOS%E3%82%A2%E3%83%97%E3%83%AA%E9%96%8B%E7%99%BA%E9%81%94%E4%BA%BA%E3%81%AE%E3%83%AC%E3%82%B7%E3%83%94100%E2%80%95%E9%96%8B%E7%99%BA%E7%8F%BE%E5%A0%B4%E3%81%A7%E5%AE%9F%E8%A8%BC%E3%81%95%E3%82%8C%E3%81%9F%E5%AE%9F%E7%94%A8%E3%82%B3%E3%83%BC%E3%83%89%E9%9B%86-%E5%A0%A4-%E4%BF%AE%E4%B8%80/dp/4798038180/ref=pd_sim_b_1)
ちょっと手の込んだ役に立ちそうな処理がたくさん紹介されててオススメ。
上で紹介した「Over&Out その後」の中の人の書籍。

##[詳解 Objective-C 2.0 第3版](http://www.amazon.co.jp/%E8%A9%B3%E8%A7%A3-Objective-C-2-0-%E7%AC%AC3%E7%89%88-%E8%8D%BB%E5%8E%9F/dp/4797368276/ref=pd_sim_b_44)
Objective-Cについて学びたいならこれ。
ちょっと難しいかも。

##[エキスパートObjective-Cプログラミング -iOS/OS Xのメモリ管理とマルチスレッド](http://www.amazon.co.jp/%E3%82%A8%E3%82%AD%E3%82%B9%E3%83%91%E3%83%BC%E3%83%88Objective-C%E3%83%97%E3%83%AD%E3%82%B0%E3%83%A9%E3%83%9F%E3%83%B3%E3%82%B0-%EF%BC%8DiOS-OS-X%E3%81%AE%E3%83%A1%E3%83%A2%E3%83%AA%E7%AE%A1%E7%90%86%E3%81%A8%E3%83%9E%E3%83%AB%E3%83%81%E3%82%B9%E3%83%AC%E3%83%83%E3%83%89%EF%BC%8D-%E5%9D%82%E6%9C%AC/dp/4844331094/ref=pd_sim_b_12)
Objective-Cでのマルチスレッドやメモリ管理といった少し複雑な処理について詳しく解説。
これが読めたら脱初心者。
一度は読んでおきたい。

##[iOS開発におけるパターンによるオートマティズム](http://www.amazon.co.jp/iOS%E9%96%8B%E7%99%BA%E3%81%AB%E3%81%8A%E3%81%91%E3%82%8B%E3%83%91%E3%82%BF%E3%83%BC%E3%83%B3%E3%81%AB%E3%82%88%E3%82%8B%E3%82%AA%E3%83%BC%E3%83%88%E3%83%9E%E3%83%86%E3%82%A3%E3%82%BA%E3%83%A0-%E6%9C%A8%E4%B8%8B-%E8%AA%A0/dp/4861007348/ref=pd_sim_b_3)
RSSリーダーを作成する事を題材にクラス設計などについても紹介されている。
簡単なコードは書けるようになってきたけど、次どうすればいいかわからない・・・
そんな人にオススメ。
自分もこれを読んで勉強しました。

##[iOS Core Frameworks テクニカルガイド](http://www.amazon.co.jp/iOS-Core-Frameworks%E3%83%86%E3%82%AF%E3%83%8B%E3%82%AB%E3%83%AB%E3%82%AC%E3%82%A4%E3%83%89-Shawn-Welch/dp/4844332724)
CoreFrameworkに焦点を当てている。
CoreData、位置情報、グラフィック、音声周りと色々紹介されていてとてもありがたい書籍。
こういった機能に焦点を当てて紹介している書籍は割と少ないので貴重。


----


良書があれば随時追加していく予定。

![golang]

Go言語を始めて38日たったので、これからGo言語を始めるプログラマにちょっとでもヒントになるように、どのようにGo言語を始めて、どのような手順で学んできたかまとめておきます。

# 筆者のバックグランド

* PHP歴、JavaScript歴10年~
* Python 3ヶ月くらい
* Ruby 1日
* 静的言語経験ほぼ皆無(Java 3日くらい、Scala 3日くらい、Objective-C 1週間くらい、Cそもそも挫折、C# 1日)

静的言語というと、「コンパイルの一手間が面倒」だとか「環境を作るのが面倒」だとか先入観があり、ほぼ食わず嫌い状態でした。

# Go言語とは?

Go言語は2009年にGoogleによって作られたオープンソースの静的言語で、Linux・Mac・WindowsやAndroidで動作します。最近ではGoogle App Engineで使うこともできます。

[golang.jpの解説](http://golang.jp/about_go)によると次のような特徴があります。

* シンプルな言語である。
* コンパイル・実行速度が早い。
* 安全性が高い。
* 同期処理が容易に行える。
* なにより楽しい。
* オープンソースである。

# なぜGo言語を学んだか?

ひとことで言うと並行処理を簡単に書きたかったからです。Go言語にはGoルーチンというシンプルな並行処理の仕組みがあります。たまたま業務で、同時に複数台のHTTPサーバーにリクエストを出して大量の命令と大量のデータを並行処理するプログラムを実装する必要が出てきて、得意なPHPでは難しいのでGo言語を学ぶことにしました。言語にはそれぞれ特徴があって、適材適所だと思っています。

# 読んだ本



Go言語を始める前に、『[はじめての「Go言語」](http://www.amazon.co.jp/gp/product/4777515591?ie=UTF8&camp=1207&creative=8411&creativeASIN=4777515591&linkCode=shr&tag=suinyeze-22&f_rd_p=466449256&pf_rd_s=lpo-top-stripe&pf_rd_t=201&pf_rd_i=4863541171&pf_rd_m=AN1VRQENFRJN5&pf_rd_r=0WA4QMWKHBWB1PVGQH0X)』をパラパラと読みました。じっくり読むというよりは最低限必要なこと、例えば、基本的な`if`や`for`などの構文の書き方、私のやったことある言語にないGoルーチン(並行処理ができる)の概念などを読んで学びました。


# 参考にしたドキュメント

ドキュメント英語版: http://golang.org/doc/
ドキュメント日本語版: http://golang.jp/go_spec

# Go関連情報のググり方

「go」だけで検索するとGo言語の情報がヒットしにくい問題があります。英語の情報を探すときは「golang」、日本語の情報を探すときは「Go言語」といったキーワードで探すと情報を見つけやすくなります。

# どのようなことを学んだか?

ここからは、38日間にどのようなことを学んできたか、Qiitaに投稿した記事を振り返りながら、概ね時系列でご紹介します。

## Go言語の実行環境を作る入門以前の段階

* MacにGoをどうやってインストールするのか?
* そもそもどうやって実行するのか?
* コンパイルはどうするのか?
* Macで作った実行形式がLinuxで使えるのか?

このような疑問を解決するために調べた内容をまとめた最初の記事です。

2013-12-04 [PHPerだが今日初めてGo言語に手を出してみる試み](http://qiita.com/suin/items/a0b7eb585eeb6bda4174)

## ひとつのファイルにガリガリ書くだけの段階

さすがに1ファイルに収まらない量になってきたので、複数のファイルにコードを分けることについて学ぶ。

2013-12-05 [Go言語のpackageの作り方: 長くなったコードを別ファイルに切り出す方法](http://qiita.com/suin/items/f4ad02e4123c8a3c75eb)

## 試行錯誤の段階

学んでいく過程でstackoverflowやQiitaに出てくるスニペットを試してみたくなりました。そこで、スニペットをさくっと実行できる環境を構築することにしました。

2013-12-05 [ワンクリックでGoのスニペットを試せる環境を作る!: CodeRunnerの設定方法](http://qiita.com/suin/items/599057e5e30627d2ed10)

## 言語仕様の理解を深める段階

Go言語を使うモチベーションが並行処理にあったので、真っ先にGoルーチンについて学びました。また、オブジェクト指向プログラミングを実践するにあたって、オブジェクトの作り方といった基礎的な言語仕様について学びました。

2013-12-05 [Goルーチンで並列化する方法: 6秒かかる処理を3秒にしよう](http://qiita.com/suin/items/82ecb6f63ff4104d4f5d)
2013-12-10 [Go言語でオブジェクトを作ってみる: オブジェクト・メソッド・コンストラクタなど](http://qiita.com/suin/items/b2a81227c75c51579c04)

## 実際にアプリを開発する段階

アプリの開発に着手した段階です。ライブラリ・モジュールの具体的な使い方について調べていました。

2013-12-07 [こんなに簡単! Goで作るRESTサーバー](http://qiita.com/suin/items/f32fa82d6c35a34e8d16)
2013-12-10 [Go言語でファイル操作: ディレクトリの作り方](http://qiita.com/suin/items/af8f306dc6b38a293ef5)
2013-12-10 [Go言語でファイル操作: ファイルを作って書き込む](http://qiita.com/suin/items/7eb4fc405ac73846a9b1)
2013-12-10 [Go言語でコマンドが実行可能かチェックする](http://qiita.com/suin/items/2724f15fff9c1948c5b3)

> この頃、PHPerでGo言語はじめたての僕が「型の宣言めんどくさい」とか「ポインタなんてなんで用意したし」とか不満を言っていたら、僕より先にGoを始めてた同僚に「Goに入ればGoに従えと言うじゃないですか」と言われる(笑)

2013-12-11 [Go言語のクロスコンパイル設定値 $GOOS, $GOARCH 一覧リスト](http://qiita.com/suin/items/7ddfcbc708c8863ea76a)
2013-12-11 [Go言語: ディレクトリ内の全ファイルをフォーマットする方法](http://qiita.com/suin/items/9f9bdaa0cb9cb80cf752) (コードスタイルがぐちゃぐちゃになって気持ち悪くなってきた頃)
2013-12-11 [Go言語でRESTful APIクライアント: Qiita APIを叩いてみよう!](http://qiita.com/suin/items/2a38f3e072523fa49a5b)
2013-12-11 [Go言語でPHPのvar_dumpやJavaScriptのconsole.log的なもの](http://qiita.com/suin/items/d952fb963956ac31b243) (そろそろデバッグを覚えたいと思った頃)
2013-12-12 [Go言語でランダムな文字列を生成する](http://qiita.com/suin/items/062dab1e6dc82c81c320)
2013-12-12 [Go言語でPHPのarray_chunkのようなことをする](http://qiita.com/suin/items/d0deb76ff03373b22a0b)
2013-12-12 [Go言語でCSVを書き出す!エクセル用のSJIS版も!](http://qiita.com/suin/items/bb9d817af5ccedb18be9)
2013-12-18 [Go言語:SJISのCSVファイルを読み込む!](http://qiita.com/suin/items/23b2c2e7cb7c80ca857e)
2013-12-18 [Go言語: SJISのCSVを読み込みながら1行毎に処理を実行する](http://qiita.com/suin/items/347ecda071a6999e5d22)
2013-12-18 [Go言語: PHPのarray_combine()のような処理をする関数](http://qiita.com/suin/items/3e978caa0c7f4ffcdd97)
2014-01-06 [[教えて]Go言語:なぜインターフェイスはポインタにできない?](http://qiita.com/suin/items/68ed7020d21dca047a73) (このあたりからやっとポインタを意識し始める)
2014-01-07 [Go言語:変数が関数かどうかを返す関数](http://qiita.com/suin/items/468108496cd0dc002f64)
2014-01-07 [Go言語:メソッドの引数の型を調べる方法](http://qiita.com/suin/items/ec2070fde6700ffc4a7f)
2014-01-10 [Go言語:Riakに書き込む](http://qiita.com/suin/items/942773fd059272825eb8)


##「そろそろテストを書かなきゃ」と思い始めた段階

モジュール化やオブジェクト指向プログラミングをGo言語でできるようになってきて、一ファイルの一枚岩コードから脱却していました。テストも書きやすい状態になっていたので、単体テストのやり方について学びました。また、切り出したコードをオープンソースとして公開したり、継続的インテグレーションのやり方について学びました。

2013-12-27 [Go言語: 単体テストの始め方！Gospelを使ってBDDをやってみよう](http://qiita.com/suin/items/71f28f06e7a49414cc93)
2014-01-06 [Go言語：単体テストを複数のパッケージに対して実行する](http://qiita.com/suin/items/850b39625c92437d2362)
2014-01-08 [Go言語:自分のライブラリをGitHubで公開する方法+drone.ioで継続的インテグレーション](http://qiita.com/suin/items/1237f210ef9e81b6475d)



# マスコット Gopher

このかわいいマスコットは、Go言語のマスコットです。Gopherと言います。日本語ではホリネズミというそうです。

<center>Gopherのフィギュア

</center>



# 使ってみて気づいたGo言語の魅力

Goを始めて3日目たったころにGoの魅力を感じ始めました。下記はそのときに書いた感想です。


> * クロスコンパイルが超カンタン。Macで開発しててもLinux、Windows用のバイナリが作れる
> * コンパイル時にポカミスが洗い出される。動的言語にはない安心感
> * まるでスクリプト言語を書いてる感覚。いつコンパイルしてるの? 型推論すごすぎ!
> * 並行処理たったそれだけでできるの!?
> * ビルドすると一つの実行形式バイナリファイルになる! このポータビリティは気持ちいい
> * パッケージ管理システムがビルトインなので、"import github.com/user/project" って書くだけでパッケージがすぐ使える! 神!
> * defer。finallyがない言語はやってらんないと思ってたけど、deferのほうがいいじゃん!
> * どんな汚いコードを書いてもGoが整頓(format)してくれる。コーディング規約じゃなくて、自動フォーマットでコードの個人差を吸収するほうが健全な気がしてきた
> * ドキュメントがしっかりしてる。
> * タブインデントがデフォ! 俺得


# Go言語はこれからどこで役立つ?

DevOpsやImmutable Infrastructureなどインフラ構築では今後欠かせなくなりそうな [Docker]、[Packer]、[Serf]といったオープンソースはGoで書かれています。これらのプロダクトは既に注目されていますが、今後ますます標準的なものになっていくだろうと予想します。そうした中でDevOpsを中心にGoで書かれるプロダクトも増えていくのではないでしょうか。

<center>Go言語のトレンド [Google Trands](http://www.google.com/trends/explore#q=golang&date=1%2F2009%2061m&cmpt=q) より


</center>

# Go言語を学んで変わったこと

僕は15歳から22歳までずっと趣味のアマチュアプログラマでした。当時は好きなコードを好きなように書いていて、ストレスフリーでコーディングそのものが楽しいと感じていました。

趣味のコーディングと業務のコーディングの決定的な違いは、「品質に責任を負うかどうか」という点だと思います。品質を担保するために、ドメイン駆動設計やDevOps、テスト駆動開発、リーンソフトウェア開発、オブジェクト指向、アジャイル、デザインパターン、継続的デリバリーといった言語を超えた上位レイヤにばかり注目していて、コーディングは単なる作業になっていました。

Goは「プログラミングは楽しくあるべき」という考えから生まれた言語らしいです。その思想はいろんなかたちで現れてて、書けるようになればなるほど楽しくなる言語だと思います。ひさしぶりにコーディングそのものの「楽しさ」を思い出すことができました。

---

もしGoをやっていて困ったときは、suinがチャットで相談に乗ります。もちろん、無償です(๑•̀ㅂ•́)و✧ [suinのプログラミング相談室](https://help.suin.io/)


[Packer]: http://www.packer.io/
[Docker]: https://www.docker.io/
[Serf]: http://www.serfdom.io/
[golang]: https://qiita-image-store.s3.amazonaws.com/0/889/5bc1dd05-2d92-e4bc-afa0-7c6cfe1eb6d7.png

by @mixiappwchr

iOSで開発する上で見ておくべきサービスやツールをまとめてみました。
ほかにもたくさんあると思いますが、基本的なやつを集めました。

アプリ配布
----

depolygate

https://deploygate.com/?locale=ja

旧TestFlightがオワコンのため、今ではDeployGateを使うしかありません！

[まだTestFlight使ってたの？急げ！終了目前のTestFlightから,今すぐにiOSもDeployGateに移行しよう！移行パターンも紹介するよ。](http://qiita.com/appwatcher/items/632460e15fbdb81b7a71)



CI
----
Circle CI
https://circleci.com/

iOS対応されアプリもクラウドでCI


クラッシュログ
----
Crittercism
https://www.crittercism.com/

ユーザービリティテスト
---
Repro
https://repro.io/

リモートでユーザーの行動をアプリの実際の画面や操作しているユーザーの表情、音声まで録画してアップロード、解析できるサービスです


バグに負けない。

ライブラリ管理
----
cocoapods
http://cocoapods.org/
ないともう無理です。

cocoapodsの検索、人気順などのサイトも
http://cocoapods.wantedly.com/




UIライブラリ集

----
cocoacontrols
https://www.cocoacontrols.com/


ちょっとしたときに使えるものがあったりします。
実装の参考にも

アプリストア解析
----
appannie
http://www.appannie.com/


自分のアプリの動向や海外ではやっているアプリの情報なども確認できますね。

アプリ解析
----
Google Analytics
http://www.google.co.jp/intl/ja/analytics/


Flurry
http://www.flurry.com/

Google analyticsにない情報もあり、こっちを使うのもあり

マネタイズ
----
数が多すぎるので２つだけ。
Admob
http://www.google.co.jp/ads/admob/



nend
http://nend.net/

日本だとnendが良さそうですね。

Baas
----
parse
https://parse.com

pushの部分だけでも便利ですね。

mobile backend starter
https://developers.google.com/cloud/samples/mbs/

google さんのやつや

aws sns
http://aws.amazon.com/jp/sns/

amazonさんのやつ

UI/UXのネタ
----
UI大事です。

dribbble
http://dribbble.com/


pinterest
http://jp.pinterest.com/
pinterstもUI/UXのボードなどみると、インスピレーションが色々わきます。

sixux
http://sixux.com

UIのアニメーション、インタラクションの参考に非常になりますね。iOSは細かい部分のインタラクションがキモです

capptivate.co
http://capptivate.co/
こちらはUIコンポーネントやトランジッションパターンごとにきれいに分類されているため見やすいです


プログラミング情報源
----
stackoverflow
http://stackoverflow.com/

だいたいのことはここに詰まってます。

qiita
http://qiita.com/

ここ！

UIモックアップ
----

ツール
----
有料ですが、便利

reveal
http://revealapp.com/

webのようにUIの解析ができるツール

SparkInspector
http://sparkinspector.com/
Revealに類似しているツールでSparkInspectorという製品を使っています。ビューとNotificationを検査することが出来てます。後者が意外と便利。[keyさんより](http://qiita.com/key)

Reflector
http://www.airsquirrels.com/reflector/

airplayで端末を表示。アプリのレビューに便利。


Sketch
http://www.bohemiancoding.com/sketch/
AppStoreで購入できるデザインツールで、iOSデバイスに作成中のデザインをライブプレビューできます。デザイナ寄りのツールですが、UIパーツのサイズ感がわかるので重宝しています。[keyさんより](http://qiita.com/key)


MAKEAPPICON
http://www.makeappicon.com/
1024x1024 の画像から iOS7の120xのアイコンを作ってくれるサイトです.[u16suzu@githubさんより](http://qiita.com/u16suzu@github)

ほかに役に立つものがあればぜひ教えてください！


##### appwchr post
----
[あんなすごいエンジニアともであえるかも？？Qiitaユーザーが集まるSlack Teamを作ってみたよ！](http://qiita.com/appwatcher/items/00faadbf02f691186a54)

[goからiOSまで一人でアプリ開発をしてたらいつの間にかマインクラフトエンジニアになった話](http://qiita.com/appwatcher/items/6c0280cda9c4c8b3c65f)

[API開発の効率化の架け橋！APIのStubサーバーを導入して,API開発に効率化、スピード化、柔軟性を手に入れよう！](http://qiita.com/appwatcher/items/49807e72d9600db7196d)

[アプリエンジニアから見てAPI設計において気をつけてもらえるとうれしいこと](http://qiita.com/appwatcher/items/4a0dd09c393cc70d961a)

[Goodbye... Jenkins... Jenkinsを卒業してお手軽CI! iOSもAndroidもCircle CIでアプリのCIを回そう](http://qiita.com/appwatcher/items/4cdf39804d6e46ab7af5)

[まだTestFlight使ってたの？急げ！終了目前のTestFlightから,今すぐにiOSもDeployGateに移行しよう！移行パターンも紹介するよ。](http://qiita.com/appwatcher/items/632460e15fbdb81b7a71)

[Swiftを使ってみて直面した闇。現時点で現場でSwiftを採用すべきかどうかの判断材料](http://qiita.com/appwatcher/items/50295e82ab0095902aaa)

[iOSの開発をする上で絶対に使うべき！外せない！webサービス、開発ツール集【完全版】](http://qiita.com/appwatcher/items/07a3babcb9b6cefb307e)

[注目のiBeacomなどの波に乗り遅れないために！iOSのBluetooth開発を容易にするライブラリを書きました。]
(http://qiita.com/appwatcher/items/7491beffd7260b713542)

[まだまだあった！iOSの開発を劇的に改善する最新のwebサービス、開発ツール集１]
(http://qiita.com/appwatcher/items/f0024fe2ac34da345f04)

[さらに快適なアプリ開発を！iOSの開発をもっと劇的に改善する最新のwebサービス、開発ツール集2]
(http://qiita.com/appwatcher/items/c15d7311e71b4c2b77f1)

[スパゲッティから脱出！iOS開発における遷移の問題をすっきり解決する便利ルーティングライブラリをご紹介]
(http://qiita.com/appwatcher/items/259e8d13fff0547e90af)

#javascriptの「this」は「4種類」？？

この記事ではベースとなる４種類の「this」を紹介します。

実際は４種類ではないのですが、
このベースの４種類を理解できれば他もすぐに理解できます。


#thisの４種類のパターン

１：メソッド呼び出しパターン
２：関数呼び出しパターン
３：コンストラクタ呼び出しパターン
４：apply,call呼び出しパターン

ここで重要なのは「呼び出し元」をみることです。
なぜなら「呼び出し元」に「this」は左右されるからです。



#メソッド呼び出しパターン
これはもう一番直感的にわかりやすいです。
説明はいらないんじゃないかという感じなのですが、
一応ソースを。。

```javascript:メソッド呼び出しパターン
//メソッド呼び出しパターン
var myObject = {
value: 10,
show: function() {
console.log(this.value);
}
}
myObject.show(); // 10
```

かなり直感的ですね。
thisにはmyObjectが入っています。


#関数呼び出しパターン

関数とメソッドと二つの呼び方をしてるのが、
ややこしく聞こえるかもしれません。

ただコードを見たらすぐに理解できます。


```javascript
myObject.show(); // メソッド呼び出し
show(); // 関数呼び出し
```

「.」で呼ばれているかどうかの違いのみですね。

では関数呼び出しパターンの「this」はいかに…

```javascript:関数呼び出しパターン
function show() {
console.log(this);
this.value = 1; // 注１
}
show(); // thisはグローバルオブジェクトをさす
```
この場合は「this」は「グローバルオブジェクト」を指してしまいます。
なので、注１の「value」は「グローバル変数」となります。

これを抑えておくのがポイントです。
次の例を考えてみましょう。

```javascript:関数呼び出しパターン
var myObject = {
value: 1,
show: function() {
console.log(this.value); // 注１

function show() {
console.log(this.value); // 注２
}
show();
}
};
myObject.show();
```

ここで注１と注２の答えはわかりましたか？

注１の「this.value」は「１」
注２の「this.value」は「undefind」

注１は一つ目のメソッド呼び出しパターンですね。
注２が最初紛らわしいです。。

メソッド呼び出しの中で関数呼び出しされているので、
あくまで注2の「this」はグローバルを指してしまいます。

メソッド内で関数呼び出しになっているっていうのが落とし穴ですね。
でもこれも簡単に解決できます。

```javascript:関数呼び出しパターン
var myObject = {
value: 1,
show: function() {
var self = this;
console.log(self.value); // 1

function show() {
console.log(self.value); // 1
}
show();
}
};
myObject.show();
```


「this」を別の変数で持っておきます。この手法はよく使われます。
慣用的に変数は「self」, 「that」, 「_this」のどれかが使われる事が多いです。


#コンストラクタ呼び出しパターン
次はコンストラクタ呼び出しパターンです。

```javascript:コンストラクタ呼び出しパターン
function MyObject(value) {
this.value = value;
this.increment = function() {
this.value++;
};
}
var myObject = new MyObject(0);
console.log(myObject.value); // 0

myObject.increment();
console.log(myObject.value); // 1
```

これもこれだけみるとわりと直感的ですね。

「new」をつけてインスタンス生成ってことですね。
そしてその生成されるインスタンス自身が「this」にsetされます。

ただ気をつけたいのが、これはただの「関数」です。。

「new」をつけなかった場合,
MyObject(0);

これは関数呼び出しなので、
「this」はグローバルオブジェクトを指してしまいます。。

この場合はvalueとincrementは
二つともグローバル変数として定義されることになります。

コンストラクタ呼び出しを期待する場合は、
最初の文字を大きくするのが慣例ですので、この場合は「new」は必ずつけましょう！

#apply, call呼び出しパターン
これは「this」を好き勝手に設定できますよっていうことです。
ライブラリとかを自作するときは非常に重宝します。

```javascript:apply,call呼び出しパターン
var myObject = {
value: 1,
show: function() {
console.log(this.value);
}
};
var yourObject = {
value: 3
};

myObject.show(); // 1

myObject.show.apply(yourObject); // 3
myObject.show.call(yourObject); // 3
```

「apply」と「call」を使うと「強制的にthisを束縛」できます。
「apply」と「call」の第一引数は「this」にsetしたいオブジェクトです。

あれ？…じゃあ「apply」と「call」は何が違うのかって、
それは第二引数以降の取り方が変わってきます。

```javascript:apply,call呼び出しパターン
var myObject = {
add: function(value1, value2) {
console.log(this.value + value1 + value2);
}
};
var yourObject = {
value: 3
};

myObject.add.apply(yourObject, [2, 10]); // 15
myObject.add.call(yourObject, 2, 10); // 15
```

「apply」は第二引数に配列をとり、配列の中身が引数として渡されます。
「call」は直感的で、第二引数以降がそのまま渡されます。

二つとも第一引数は「this」で、その後の引数の取り方が違うだけです。


#まとめ
「呼び出し元」に気をつけろ！
覚えるべきベースは４種類。

１：メソッド呼び出しパターン
２：関数呼び出しパターン
３：コンストラクタ呼び出しパターン
４：apply,call呼び出しパターン

てな感じです。
あっさりまとめたので、わからないところがあれば聞いてください♪

それからコンストラクタについて詳しく知りたい方はこちら
[JavaScriptのクラス？コンストラクタ？](http://qiita.com/items/010752b1427773558f7c)

# 外部アカウント

技術情報のみつぶやくアカウント作成しました。JavaScriptは最新情報も追っていきます。
[Twitterはこちら]
(https://twitter.com/takeharumikami)
[Feedlyのフォローはこちら]
(http://cloud.feedly.com/#subscription%2Ffeed%2Fhttp%3A%2F%2Fqiita.com%2Ftakeharu%2Ffeed)

# おすすめの記事
もういい時期です。そろそろ始めましょう。ECMAScript6。
[もうはじめよう、ES6~ECMAScript6の基本構文まとめ(JavaScript)](http://qiita.com/takeharu/items/cbbe017bbdd120015ca0)

JavaScriptはオブジェクト指向？プロトタイプベースのオブジェクト指向を学ぶなら。
[JavaScriptのプロトタイプからオブジェクト指向を学ぶ](http://qiita.com/takeharu/items/809114f943208aaf55b3)

JavaScriptでは関数はすべてクロージャ。
[そもそもクロージャって？JavaScriptでクロージャ入門](http://qiita.com/takeharu/items/4975031faf6f7baf077a)

# 背景

自前のサービスでhttps通信をサポートするには、SSL証明書が必要になります。
自分で使用するだけなら、SSL証明書も自前で作成するいわゆるオレオレ証明書を用いても良いのですが、外部に公開するサービスの場合そうとも行きません。
SSL証明書というと値段が高い印象がありましたが、[StartSSL](https://www.startssl.com/)というサービスで無料でSSL証明書の発行を受けられると言うことで試してみました。

# StartSSLにユーザー登録する

証明書の発行を行う前に、StartSSLにユーザー登録する必要があります。
[StartSSL](https://www.startssl.com/)から、"StartSSL Free (Class1)"を選択します。


Certificate Control Panelを選択。


Sign-upに進みます。


名前、住所、メールアドレスなど
個人情報の登録を行います。


登録したメールアドレスに本人確認のメールが届くので、受信したメールのauthentication codeを入力して登録を完了させます。
この時、「もっと詳細な住所を教えて欲しい」と言う旨のメールが送られてくることがあります。
その場合はStartSSLの担当者とメールをやりとりして登録を完了させましょう。


登録を完了すると、StartSSLへのログイン用SSL証明書発行のためのURLが送られてきます。
そのリンクからブラウザに証明書をインストールしましょう。
暗号化セキュリティーレベルはデフォルトの2048（高）で良いと思います。
この時にインストールした証明書が無いとStartSSLにログインできません。
他の端末や、ブラウザでアクセスする場合は証明書のエクスポートが必要になります。


# ドメインの認証

ユーザー登録が完了したら、次はドメインの認証です。
Validations Wizardタブを選択します。


証明書を発行したいドメインを登録します。


自分が管理しているドメインであることを示すために、登録したドメインのpostmaster, hostmaster, webmasterなど、いずれかのメールアドレスでメールを受け取る必要があります。
メールを受信できるように事前に設定しておきましょう。


先ほど指定した名前に確認用メールが送られてくるので、メールに記載されているコードを入力して進みます。


# 秘密鍵の発行

ドメインの認証が終わったら、秘密鍵の発行です。
Certificates Wizardタブを選択し、Certificate TargetはWeb Server SSL/TLS Certificateを指定します。


パスワードを設定して進みます。


private keyが作成されたので、テキストエリアの情報を保存します。


# 公開鍵の発行

登録したドメインを選択します。


サブドメインを登録します。


次に進むとメールを送信するという表示がされるので、メールが来るのを待ちます。
メールを受信したら、Tool Boxタブに移動し、Retrieve Certificateを選択します。


すると公開鍵が表示されるので、テキストエリアの内容を保存しておきます。


# 証明書の設置

サーバーにSSL証明書を設置し、HTTPSでの通信を出来るようにします。
今回はnginxでSSL証明書を利用できるようにしてみます。

SSL証明書を設置するディレクトリに移動します。

```
cd /etc/pki/tls/certs/
```

StartSSLの証明書をダウンロードします。

```
wget https://www.startssl.com/certs/ca.pem
wget https://www.startssl.com/certs/sub.class1.server.ca.pem
```

先ほど保存しておいた秘密鍵と公開鍵を配置します。
今回はそれぞれ`startssl.key`と`startssl.crt`と言う名前で設置しました。
例えばvimでファイルを作成して鍵の中身を貼り付けます。

```
vim startssl.key
vim startssl.crt
```

証明書と鍵のパーミッションを変更します。

```
chmod 400 startssl.crt startssl.key ca.pem sub.class1.server.ca.pem
```

Apacheを使用する場合は中間証明書を指定するディレクティブがありますが、nginxには中間証明書を直接指定するディレクティブが用意されていません。
そこでサーバ証明書と中間証明書を結合します。
証明書は順に辿らないと駄目なので、結合の順番には注意しましょう。

```
cat sub.class1.server.ca.pem >> startssl.crt
```

秘密鍵にはパスワードが設定されているため、nginxのstart/restart時にそのパスワードを入力する必要が出てきます。
自動起動する場合には不便なので、パスワードを解除する場合は以下のようにバックアップを作成した後、パスワードがない鍵を作成します。

```
cp startssl.key startssl.key.org
openssl rsa -in startssl.key -out startssl.key
```

nginxの設定を一部抜粋します。
`ssl_certificate`で中間証明書と結合した証明書を、`ssl_certificate_key `で秘密鍵を指定します。
オプションとしてSSLダウングレード攻撃を考慮して、SSLバージョン指定`ssl_protocols`,暗号スイート指定`ssl_ciphers `,暗号選択方式指定`ssl_prefer_server_ciphers `を変更しました。

```nginx
server {

listen 443 ssl;

ssl_certificate /etc/pki/tls/certs/startssl.crt;
ssl_certificate_key /etc/pki/tls/certs/startssl.key;
ssl_session_timeout 5m;
# SSLv2以下は利用しない
ssl_protocols SSLv3 TLSv1;
# 暗号スイートの指定
ssl_ciphers RC4-SHA:HIGH:!ADH;
# 暗号の選択をサーバ側で決定
ssl_prefer_server_ciphers on;

}
```

# まとめ

無料のSSL証明書ではありますが、PCブラウザおよびiPhoneからのアクセス等でも警告なくHTTPSでの接続が可能になるので便利に活用できるのではないでしょうか。


システムには障害がつきものです。どんなにしっかりと作られたサービスであっても思わぬところで、バグやミスが発覚して、トラブルになるものです。大事なのはこういった障害を次への糧にしていくこと。失敗というのは大事な資産なので、管理できるようにしましょうという話。

# あわせて読みたい

* [新人プログラマに知ってもらいたいメソッドを読みやすく維持するいくつかの原則](http://qiita.com/hirokidaichi/items/c9a76191216f3cc6c4b2)
* [新人プログラマに知っておいてもらいたい人類がオブジェクト指向を手に入れるまでの軌跡](http://qiita.com/hirokidaichi/items/591ad96ab12938878fe1)
* [ペアプログラミングして気がついた新人プログラマの成長を阻害する悪習](http://qiita.com/hirokidaichi/items/27c757d92b6915e8ecf7)
* [あきらめるにはまだ早い！ソースコードの品質向上に効果的なアプローチ](http://qiita.com/hirokidaichi/items/5a5cb63ef5499143bc40)
メンタリングの方法について基礎をまとめました。内心でなく行動を変えることが障害報告とも共通します。
* [新入社員が来てメンターになれって言われたけど、どうすればいいのかという対話テクニック](http://qiita.com/hirokidaichi/items/2e8e731acfd7b6c7e02f)

#障害の種類と障害報告について

障害には、小さなもの、たとえば画面に表示されているテキストの乱れから、すべての画面で50xエラーが発生しているもの、決済とのつなぎ込みが失敗し、金銭的な影響が大きいものなど様々あります。どのような時に障害報告を書くのかと言われれば、「できればすべて書きましょう」というのが原則になると思います。

大前提として、「障害報告は始末書や反省文ではない」ということです。仕方なく、嫌嫌恥ずかしい思いをしながら書く必要はありません。うちはそういう文化じゃないんだと言う場合は、自分たちのチームから障害報告を始めてみるとよいのではないでしょうか。

#ハインリッヒの法則、あるいはヒヤリハット
http://ja.wikipedia.org/wiki/ハインリッヒの法則

ハインリッヒの法則というものがあります。これは、１件の重大な事故の背後には29件の軽微な事故、300件のヒヤリハット事例(事故にはならなかったけど、ヒヤッとしたこと)が隠れているという統計的な経験則です。

これは、逆説的に言えば、小さな障害報告であってもしっかりとマネージすることで重大な事故を防ぐことができるだろうということを意味しています。

#障害報告のフォーマットについて

障害報告はできれば、ticket/issue管理システムなどで管理した方が良いでしょう。なければ、wikiのようなものでもかまいません。そのときのフォーマットとしては、最低限、次のようなものを用意するといいでしょう。

* 障害内容サマリ
* カスタマーフィードバック
* 障害タイムライン
* 対応差分
* 再発防止策

## 障害内容サマリ
障害内容のサマリを端的な文章で記述しましょう。このとき、やってしまいがちなのは、「起きた現象」の内容ではなくて、「原因やバグが発生しているモジュール名」などを書いてしまいがちだったりします。ここに書くべきは、技術者以外も含めたメンバーが理解できるような現象面について言及することです。

たとえば、
「HogeFuga_master DBの物理障害が発生」
ではなくて、
「Hoge表示画面でinternal server errorと表示される」
「Hogeの投稿ができない不具合が発生」
などと記述します。

これは、影響の大きさを営業部門やサポート部門と共有するためにも大事なことです。

## カスタマーフィードバック
発生した障害に関して、問い合わせの件数やその内容などを記述します。あるいは関連部門の人に記述してもらいましょう。これは、影響の大きさを可視化するのに役立ちます。また、障害発生時にそういった部門との情報共有を必要とするフォーマットになるため、障害対応から問い合わせ応答や、障害発生のお知らせを出すための連携もしやすくなります。

## 障害タイムライン
障害タイムラインとは、発生時刻、認知時刻、対応開始時刻、対応完了時刻、その他必要な時系列の対応状況に関する報告です。また、それぞれについて、「誰によって」「いつ」「どのように」がわかるとよりよいでしょう。

これを記述する理由は、再発防止策の検討の際にも役に立つからです。たとえば、発生時刻から認知時刻までの差が「２時間」であった場合、これを「１０分」にすることができるだけでも、障害の影響度は変わってきます。また、「認知時刻から対応開始まで」「対応開始から対応完了まで」の時刻も同様です。

障害の影響度については、

```
障害の影響度＝影響範囲 * 金銭的重要性 * 対応完了までにかかった時間
```
このように考えるとよいでしょう。

## 対応差分
対応差分へのリンクを必ず張りましょう。障害の理由は文章だけでは、伝わらないケースも多いです。

## 再発防止策
再発防止策は、障害報告を書く最大の理由です。障害報告を書いた時点では、すべてを記述する必要はありませんが、再発防止策が完了するまでは、チケットをクローズしないことが重要です。また、再発防止策を記述するときは、「原因(だと思ったもの)」と「対策」をしっかりと記述しましょう。なぜなら、原因だと思ったものが共有されていない場合、対策が的外れになってしまう場合もあるからです。

また、その際に

* 直接原因　：　その不具合が発生した直接的原因
* 間接原因　：　その不具合に至るまでの間接的な原因
* 本当の理由：　なぜ、このようなパターンの障害が発生したか

のように３段階くらいに再発防止策を検討していけるとよいでしょう。これが三段階なのは前述のハインリッヒの法則をイメージしてもらうとわかりやすいと思います。一つの障害には、３００のヒヤリとしている事例、あるいはメンバーの慣れや、習慣、努力によってたまたま防ぐことができている障害が隠れています。直接的な原因を潰すだけでは、再発防止策としてはあまり適していないケースが多いです。そうではなくて、もう一段トラブルを引き起こした間接的な問題がはらんでいて、その問題を解決することで本当の再発防止となることが多いからです。

また、前述の通り、障害の影響度の式をイメージして、影響度を減らすための方策も重要です。

* 影響範囲 　　　　　：同様の問題が起こっても影響範囲の極小化はできないか？
* 対応完了までの時間 ：同様の問題が起こっても、短い時間で、あるいは自動的に対応できないか？

という問いも再発防止策を検討する上では重要です。


#再発防止検討サイクルについて

## チーム振り返り
再発防止策の検討は、定期的にチームで振り返ることが大事です。この際に障害を引き起こしたチームメンバーに対する糾弾のようにならない配慮が重要です。再発防止策の検討には、かならずファシリテータを用意し、画面やホワイトボードに注目させ、また、ブレストのような自由闊達とした雰囲気づくりが重要です。お菓子を用意してもいいですし、適度なアイスブレイクも重要でしょう。

この際に、次に述べる良い再発防止策と悪い再発防止策のペーパーをメンバーは見ることができるようにしておくのも大事です。

また、これはファシリテータの仕事ですが、原因->対策という順番を忘れずに議論することが大事です。

## セカンドオピニオン
再発防止策は、チーム外のメンバーで振り返るシーンを作った方が良いでしょう。その理由の１つは、情報を他のチームのメンバーと共有することでより広範囲の問題を解決する案が出てくるかもしれないこと。もうひとつは、チームの事情によってかかるバイアスを排除した意見をもらうことができることです。チームで行動していると、忙しさから場当たり的な問題解決をしがちになりますし、それを互いに指摘し合える関係を他のチームと構築することで、障害という資産を活かすことができる文化が生まれてくるでしょう。

# 良い再発防止策と悪い再発防止策

## 良い再発防止策
良い再発防止策について、順位付けするとしたら、

1. その種類の問題について二度と意識することがなくなる解決策
1. その種類の問題を開発時に自動的に検知することができる解決策
1. その種類の問題が発生しても自動的に復旧することができる解決策
1. その種類の問題が発生しても影響が局所化される、フールプルーフ、フェールセーフになる解決策

このような順序でしょうか。

## 悪い再発防止策
悪い再発防止策は、シンプルで人間というコンポーネントを使うことです。

1. 責任回避のため稟議、決済経路を追加する策
1. 他者の努力／忍耐／根性の不足を指摘し改善を求める策
1. 個人／チームの注意力を原因とし、「より注意深く確認します／させます」といった策
1. それっぽい言い訳付きのダブルチェック/トリプルチェック体制
1. ドキュメントにその旨追記します！的な解決策

これは、そんなことやらないよと思っていると、ついついやってしまいがちなので注意が必要です。
「ちゃんと」「しっかり」というフレーズが出てきたら、危険信号です。

# まとめ
+ 障害報告は資産。どんなものでも作成し有効活用しよう。
+ 人間というコンポーネントを再発防止に入れない
+ セカンドオピニオンをもうけよう

以上です。

#はじめに
ここでは、MacBookAirで私が使っている便利ツールを紹介していきます。長文過ぎると、途中で表示できなくなってしまうことを学習したため、不要な解説は省略します。また、個人的な価値観から形成された表現を含むかもしれませんが、その点の説明も省略します。ご了承ください。
便利なアプリを知っていたら、是非コメントをお願いします。


##MacBookAirにインストールしたアプリ


01. [BetterTouchTool](http://blog.boastr.net/) //トラックパッド拡張、ショートカットキー拡張
02. [Google Chrome](http://www.google.co.jp/chrome/intl/ja/landing_ch.html) //インターネットブラウザ
03. [Growl](http://growl.info/downloads) //通知を拡張するアプリ
04. [Kopypasta](http://itunes.apple.com/jp/app/kopypasta/id463243494?mt=12) //クリップボードをバックアップ
05. [WindowFlow](http://itunes.apple.com/jp/app/windowflow/id414445104?mt=12) //ウィンドウ切り替え
06. [XtraFinder](http://www.trankynam.com/xtrafinder/) //Finderを拡張するアプリ
07. [Xcode](https://developer.apple.com/xcode/) //開発環境を提供するアプリ
08. [TinkerTool](http://www.bresink.com/osx/TinkerTool.html) //Macの隠し機能を簡単に有効にするアプリ
09. [VirtualBox](https://www.virtualbox.org/wiki/Downloads) //仮想環境を提供するアプリ
10. [Skitch](http://itunes.apple.com/jp/app/skitch/id425955336?mt=12) //スクーンショットの撮影と画像の編集を行うアプリ
11. [DashExpander](http://itunes.apple.com/jp/app/dashexpander/id458867049?mt=12) //無料の高機能エディタ
12. [Alfred](http://www.alfredapp.com/) //キーボード操作拡張
13. [Google IME](http://www.google.co.jp/ime/index-mac.html) //Google 日本語入力
14. [Dropbox](https://www.dropbox.com/) //共有ドライブ
15. [ShiftIt](http://code.google.com/p/shiftit/) //ウィンドウ操作を簡単にするアプリ
16. [Kobito](http://kobitoapp.com/) //Qiitaへの投稿を簡単にするアプリ
17. [GitHub for Mac](http://mac.github.com/) //GitHubへの投稿を簡単にするアプリ
18. [GIMP](http://www.gimp.org/downloads/) //言わずと知れた高機能の画像作成・編集アプリ
19. [Notational Velocity](http://notational.net/) //Simplenoteクライアント。メモ帳
20. [Evernote](http://www.evernote.com/about/intl/jp/) //高機能メモ帳Evernoteのクライアントアプリ。
21. [KeePassX](http://keepass.info/download.html) //パスワード管理アプリ。
22. [MacVim](http://code.google.com/p/macvim-kaoriya/) //Vimエディタの日本語拡張版
23. [iTerm2](http://www.iterm2.com/) //ターミナルアプリ。設定項目が豊富で安定しています。
24. [ClamXav](http://www.clamxav.com/download.php) //スキャン
25. [ClipMenu](http://www.clipmenu.com/ja/) //履歴機能を強化
26. [CheatSheet](http://www.cheatsheetapp.com/CheatSheet/) //ショートカットキーヘルプ
27. [NetBeans](http://ja.netbeans.org/) //日本語ドキュメントがしっかりしたIDE
28. [VLC](http://www.videolan.org/vlc/) //メディアプレイヤー
29. [Type2Phone](http://itunes.apple.com/jp/app/type2phone/id472717129?mt=12) //iPhoneのBluetoothキーボードにする
30. [dolipo](http://drikin.com/2010/11/dolipo.html) //ネット環境の高速化
31. [TeamViewer](http://www.teamviewer.com/ja/index.aspx) //WAN経由でのGUIリモート補助
32. [AccessMenuBarApps](http://www.ortisoft.de/accessmenubarapps/) //メニューバーへのアクセス改善


##Macの基本操作について


私は、トラックパッドを全く使いませんので、あまり関係ないのですが、`BetterTouchTool`よりも`jitouch 2`のほうがよさそうだという話があります。このアプリの紹介とMacの操作全般について参考になりそうな記事を載せておきます。

参考記事
01. [ガチのガチでトラックパッド操作が捗る「jitouch 2」を紹介するよ！だから「BetterTouchTool」は今すぐ窓から捨てなよ。](http://boku-note.com/mac/jitouch2_apptivate_clcllite/2155/)

##ブラウザ環境
便利なGoogleChrome拡張機能を紹介します。動作は`:help`などで確認してください。特に、[連続HIT-A-HINT](http://k2nr.blogspot.jp/2011/09/vichrome-extension.html)が便利です。


01. [ViChrome](https://chrome.google.com/webstore/detail/gghkfhpblkcmlkmpcpgaajbbiikbhpdi) //キー操作補助
02. [gleeBox](http://thegleebox.com/) //コマンド操作

##メイン環境


01. iTerm2 //Terminal
02. zsh //Shell
03. Vim //Editor
04. tmux //Virtual
05. NetBeans //IDE
06. w3m //Browser

##各種設定ファイル
長くなりすぎると、記事が途中で切れるので、設定ファイルはあくまで参考程度に一部のみ載せています。GitHubで公開されているものを参考にするのがよいと思います。

```~/.zshrc
# w3mでgoogle検索
function google() {
local str opt
if [ $ != 0 ]; then
for i in $*; do
str="$str+$i"
done
str=`echo $str | sed 's/^\+//'`
opt='search?num=50&hl=ja&lr=lang_ja'
opt="${opt}&q=${str}"
fi
w3m http://www.google.co.jp/$opt
}
```

```~/.vimrc
" jj でノーマルモードに移動する
inoremap jj <esc>
```

```~/.w3m/keymap
# m でカーソル位置のURLをクリップボードに保存する
keymap m EXTERN_LINK "echo %s | pbcopy"
```


```~/.tmux.conf
# Control+s Control+vで画面分割
bind-key -n M-s split-window -v
bind-key -n M-v split-window -h
```


参考記事
01. [tmux Keymap](https://bytebucket.org/ns9tks/tmux-ja/wiki/tmux-ja.html)
02. [tmux.conf](http://d.hatena.ne.jp/mizchi/20100829/1283076112)
02. [zshrc](http://www.clear-code.com/blog/2011/9/5.html)
03. [zsh Prompt](http://www.understudy.net/custom.html)
04. [vim Keymap](http://vim.wikia.com/wiki/Mapping_keys_in_Vim_-_Tutorial)
05. [vimrc](https://github.com/Shougo/shougo-s-github/blob/master/vim/.vimrc)
06. [w3m/keymap](https://github.com/mottram/dotfiles/blob/master/w3m/keymap)

`zsh`を簡易にカスタマイズしたい場合は、`Oh-My ZSH`を参考にするとよいでしょう。プロンプトの設定あたりが特に参考になると思います。

参考記事
01. [oh-my-zsh を使って zsh の便利な設定をまとめて取り入れる](http://d.hatena.ne.jp/mollifier/20101009/p1)

##Homebrewでインストールするアプリ



```
brew update //アップデート

brew doctor //問題解決

brew install 'Appname' //インストール

brew search 'Appname' //検索
```

以下、アプリはコマンドでインストールできるため、URLには参考記事を載せています。

01. [w3m](http://www.office-iwata.com/archives/47) //テキストブラウザ
02. [mutt](http://www.emaillab.org/mutt/) //メール
03. [git](http://www8.atwiki.jp/git_jp/) //バージョン管理
04. [mplayer](http://pspfour.blog106.fc2.com/blog-entry-1111.html) //メディアプレイヤー
05. [ffmpeg](http://pspfour.blog106.fc2.com/blog-entry-1111.html) //エンコード
06. [swftools](http://pspfour.blog106.fc2.com/blog-entry-1111.html) //swfのエンコード
07. [mc](http://ja.wikipedia.org/wiki/Midnight_Commander) //ファイルマネージャ-Midnight Commander
08. [zsh](http://news.mynavi.jp/column/zsh/index.html) //補完が冴えたシェル
09. [vim](http://ja.wikipedia.org/wiki/Vim) //プラグインが優れたエディタ
10. [tmux](http://d.hatena.ne.jp/tmatsuu/20090709/1247150771) //ウィンドウ操作に優れた仮想環境
11. [devtodo](http://pnuts.cc/2009/12/devtodo/) //To-do管理
12. [googlecl](http://code.google.com/p/googlecl/) //Googleサービスの利用
13. [youtube-dl](http://pspfour.blog106.fc2.com/blog-entry-1111.html) //YouTube動画のダウンロード
14. [nmap](http://nmap.org/man/jp/) //ネットワークスキャナ
15. [wireshark](http://www.wireshark.org/) //パケット解析ツール
16. [munin](http://munin-monitoring.org/) //初心者に手軽なサーバー管理
17. [aircrack-ng](http://www.aircrack-ng.org/doku.php?id=ja:cracking_wpa) //無線キャプチャ
18. [metasploit](http://www.ibm.com/developerworks/jp/web/library/wa-metasploit/) //脆弱性評価ツール
19. [exiftool](http://pspfour.blog106.fc2.com/blog-entry-1027.html) //Exif情報操作
20. [mobile-shell](http://pspfour.blog106.fc2.com/blog-entry-1069.html) //SSHに変わるリモートツール
21. [rtorrent](http://libtorrent.rakshasa.no/) //Downloader

##MacPortでインストールするアプリ
たまに、`Homebrew`にはないアプリがあります。その場合、`MacPort`を使いインストールできます。なお、`Homebrew`を利用する場合、`MacPort`の導入は推奨されていませんので注意が必要です。

01. [ophcrack](http://ophcrack.sourceforge.net/) //パスワードクラック。辞書ファイルもダウンロード可
02. [snownews](https://kiza.kcore.de/software/snownews/) //RSSクライアント

##その他
01. [sheet](http://oscardelben.com/sheet/) //スニペットツール
02. [nicovideo-dl](http://pspfour.blog106.fc2.com/blog-entry-1111.html) //ニコニコ動画のダウンロード
03. [metrical](http://ja.asciicasts.com/episodes/252-metrics-metrics-metrics) //メトリクス計測
04. [google-apps-manager](http://code.google.com/p/google-apps-manager/) //Googleアカウント管理
05. [orpheus](http://ihaveapc.com/2011/04/orpheus-a-cool-command-line-mp3-player-for-linux-mint-ubuntu/) //Media Player
06. [gcalcli](https://github.com/insanum/gcalcli) //Googleカレンダーやリマインダーなど

##初期設定
パソコンを初期化したあと、もしくは他人のパソコンを使用する場合、即座に自分環境を構築する手はずを整えておきましょう。具体的には、アプリをインストール、設定するシェルスクリプトを書き、それをDropboxで共有しておきます。また、設定ファイルはGitHubに公開してもいいでしょう。

私の場合、Dropboxをインストールし、1つのコマンドを実行すれば、アプリのインストール、設定からzshなどの設定ファイルへシンボリックリンクを貼る作業までを自動で実行されるようにしています。これは、ある程度、OS環境を考慮した内容で書きます。

Check

```~/setup.sh
DOT_FILES=( .vim .vimrc .bazaar)

for file in ${DOT_FILES[@]}
do
if [ -a $HOME/$file ]; then
echo "既にファイルが存在します: $file"
else
ln -s $HOME/dotfiles/$file $HOME/$file
echo "シンボリックリンクを貼りました: $file"
fi
done
```

参考記事
01. [ボク式dotfiles](http://d.hatena.ne.jp/Yuzuemon/20120220/1329747301)
02. [DotfilesをDropboxで管理するときに若干役に立ちそうなスクリプト](https://gist.github.com/1221938)
03. [dotfile (~/.file) の類を Dropbox で一元管理](http://voqn.blogspot.jp/2011/04/dotfile-file-dropbox.html)
04. [Dropboxをサーバにインストールして簡単自動バックアップ](http://blog.monoweb.info/article/2011033122.html)


その他、Editorに`Vim`を使う場合は、`GoogleIME`の設定を行なっておくと、コマンド入力が便利になります。Google IME > 環境設定 > 一般_キー設定_編集 にて以下を変更します。これで、`Esc`を押すと、日本語入力がOFFになります。


##便利なVimプラグイン


01. [simplenote](https://github.com/mrtazz/simplenote.vim) //クラウドメモ帳
02. [commnad-t](https://github.com/wincent/Command-T) //ファイルアクセスの便宜
03. [w3m](https://github.com/yuratomo/w3m.vim) //yuratomo/w3m.vim
04. [tagbar](https://github.com/majutsushi/tagbar.git) //majutsushi/tagbar

その他のプラグインは下記を参考にしてください。なお、プラグインの導入は、`Bundle`か`NeoBundle`を使うと簡単になります。

参考記事
01. [ワシのVimプラグインは百八式まであるぞ](http://daisuzu.hatenablog.com/entry/2012/05/06/204019)

##ブログ環境
ブログ環境は、執筆環境を視野に入れた使い慣れたサービスをメインに構築するのが一番です。ここでは、私が考えるクールなブログ環境を紹介します。

01. [GitHub Page](http://pages.github.com/) //無料で使える公開ページ
02. [Bitbucket](https://bitbucket.org/) //非公開に対応
03. [Octopress](http://octopress.org/) //Webアプリケーションの一種
04. [Dropbox](https://www.dropbox.com/) //ファイルサーバー

参考記事
01. [Octopressのインストールから運用管理まで](http://tokkonopapa.github.com/blog/2011/12/30/octopress-on-github-and-bitbucket/)
02. [Octopress + Github Pages + Dropbox でブログを構築](http://www.sankitch.me/blog/2012/05/05/build-octopress-on-github-dropbox/)

##使ってないけど有効なツール
01. [Eclipse](http://www.eclipse.org/downloads/) //IDE
02. [Coda2](http://panic.com/jp/coda/) //IDE or Editor ? IDE
03. [Emacs](http://ja.wikipedia.org/wiki/Emacs) //Editor

###なぜ、これらのツールを使わないのか?
これはあくまで個人的な意見ですが、`Eclipse`は日本語ドキュメントが不足しているような気がします。よって、初心者には敷居が高いです。`Coda2`はMac限定で、他のOSとの設定の共有が難しいと考えます。`Emacs`は`Vim`と比べた場合、私が求めるプラグインが多少不足している印象があります。なぜ、これらのツールを使わないのか?その理由のほとんどは、私が初心者であることが一番の原因だと思います。


##VirtualBoxなどで使っているOSと便利ツール


01. [Cygwin](http://www.cygwin.com/) //Windowsでunix環境を再現
02. [MinGW](http://sourceforge.net/projects/mingw/files/Installer/mingw-get-inst/) //cygwin同様
03. [mintty](http://code.google.com/p/mintty/) //cygwinのTerminal
04. [Msiexec.exe](http://support.microsoft.com/kb/314881/ja) //Windowsインストーラー
05. [Xubuntu](http://xubuntu.org/) //ubuntuを軽量に再構築
06. [Gentoo](http://www.gentoo.gr.jp/) //Gentoo Linuxは、開発に特化したOS
07. [BackTrack](http://www.backtrack-linux.org/) //脆弱性検査や無線LANツールが豊富

参考記事
01. [Windowsで最高のターミナルを構築する方法](http://tanakh.jp/posts/2011-11-15-windows-terminal.html)
02. [Gentoo Haskell Overlay 使うときの基本的な設定](http://d.hatena.ne.jp/notogawa/20120603/1338738104)
03. [BackTrackを使ってセキュリティをテストする](http://www.itmedia.co.jp/enterprise/articles/0806/19/news035.html)

## GIMPのプラグイン一覧


01. [Separate+](http://cue.yellowmagic.info/softwares/separate.html) //CMYKファイルを扱うプラグイン
02. [PSPI](http://tml.pp.fi/gimp/pspi.html) //Photoshop用のプラグインをGIMPでも使う
03. [Liquid Rescale](http://liquidrescale.wikidot.com/en:start) //画像のリサイズに使えるプラグイン
04. [Wavelet Denoise](http://registry.gimp.org/node/4235) //ノイズを除去するためのプラグイン
05. [Gimp-reflection](http://registry.gimp.org/node/1025) //特殊効果としての反射を行うプラグイン
06. [Z-design Tech brushes set v2](http://z-design.deviantart.com/art/Z-design-Tech-brushes-set-v2-20701749) //サイバー風ブラシセット

##人気のある有料アプリ


ここでは、一般的に人気があるMacの有料アプリを紹介してみたいと思います。

01. [PopClip](http://pilotmoon.com/popclip/) //マウスのCopy補助
02. [MarsEdit](http://www.red-sweater.com/marsedit/) //ブログエディタ `代替 : Vim`
03. [Transmit](http://panic.com/jp/transmit/) //FTPクライアント
04. [1Password](https://agilebits.com/onepassword) //パスワード管理 `代替 : keepass`
05. [iStat Menus](http://bjango.com/mac/istatmenus/) //CPUやメモリ監視 `代替 : topとvm_stat`
06. [Vmware fusion3](http://www.act2.com/software/vmware/fusion3) //仮想環境 `代替 : VirtualBox`
07. [Osfoora](http://www.osfoora.com/mac/) //Twitterクライアント `代替 : tweetvim`
08. [MenuPop](http://www.binarybakery.com/) //右クリックメニューの呼び出し
09. [TextExpander](http://itunes.apple.com/jp/app/textexpander-for-mac/id405274824?mt=12) //入力補完 `代替 : sheet`
10. [Photoshop](http://www.adobe.com/jp/products/photoshop.html) //画像編集 `代替 : GIMP`
11. [Illustrator](http://www.adobe.com/jp/products/illustrator.html) //グラフィックサポート

参考記事
01. [Macでtmuxのステータスラインに起動時間/ロードアベレージ/メモリ使用率を表示](http://d.hatena.ne.jp/yonchu/20120414/1334422075)


##最後に
私は、パソコンのことは何もわからない初心者なので、色々と教えて下さい。また、WindowsやLinuxで使用されている便利なアプリについても教えて欲しいです。OSに限定はなく、どんどんコメントいただきたいと思っています。


##追記

FireAlpaca [http://firealpaca.com/](http://firealpaca.com/)

Alfred 2 [https://www.alfredapp.com](https://www.alfredapp.com)

この記事は [Git Advent Calendar](http://qiita.com/advent-calendar/git) 6日目の記事です！
Git submodule って最初わかりにくいと思うので、基本的な説明をしようと思います。

## git submodule とは

`git submodule` は、外部の git リポジトリを、自分の git リポジトリのサブディレクトリとして登録し、特定の commit を参照する仕組みです。
Subversion でいうところの、external と似ています。


さて、解説のため、手元に、リポジトリA (/path/to/a) とAの submodule として、よく使う例として Bootstrap (元Twitter Bootstrap) を登録してみます。

git submodule を理解するうえで重要なのは、

* リポジトリAが指し示すsubmoduleとしてのBootstrapのcommit
* 現在のBootstrapのcommit

です。


## git submodule add してみる

では、リポジトリA内、submodule add してみます。

```bash:
$ git submodule add https://github.com/twbs/bootstrap.git bootstrap
Cloning into 'bootstrap'...
remote: Counting objects: 73135, done.
remote: Compressing objects: 100% (15/15), done.
remote: Total 73135 (delta 6), reused 0 (delta 0), pack-reused 73120
Receiving objects: 100% (73135/73135), 85.84 MiB | 3.91 MiB/s, done.
Resolving deltas: 100% (44541/44541), done.
Checking connectivity... done.
```

これで 手元の `bootstrap` ディレクトリに、GitHub にある Bootstrap が submodule として登録されました。
git status をみてみると .gitmodules というファイルと、submodule の入れものである `bootstrap` というディレクトリが新しく登録されています。

```bash:
$ git status
# On branch master
# Changes to be committed:
# (use "git reset HEAD <file>..." to unstage)
#
# new file: .gitmodules
# new file: bootstrap
#
```

diff も確認します。


```diff:
$ git diff --cached
diff --git a/.gitmodules b/.gitmodules
new file mode 100644
index 0000000..2fdbccb
--- /dev/null
+++ b/.gitmodules
@@ -0,0 +1,3 @@
+[submodule "bootstrap"]
+ path = bootstrap
+ url = https://github.com/twbs/bootstrap.git
diff --git a/bootstrap b/bootstrap
new file mode 160000
index 0000000..5c02844
--- /dev/null
+++ b/bootstrap
@@ -0,0 +1 @@
+Subproject commit 5c028448c1fc171cf4a0fd99d3a672b649bef2aa
```

注目すべきは、 `+Subproject commit 5c028448c1fc171cf4a0fd99d3a672b649bef2aa` の diff で、これは、

* Bootstrap の、 `5c028448c1fc171cf4a0fd99d3a672b649bef2aa` コミットを、
* `bootstrap` ディレクトリに Submodule として登録した

という意味になります。
これをコミットしておきます。

```bash:
$ git commit -m "Add Twitter Bootstrap as a submodule"
```

では、ためしに、bootstrapディレクトリに移動して、`git show` してみると、

```bash:
$ cd bootstrap
$ git show
commit 5c028448c1fc171cf4a0fd99d3a672b649bef2aa
Merge: 5e7c5a6 0c4c1e4
Author: Chris Rebert <github@rebertia.com>
Date: Wed Jul 29 15:00:54 2015 -0700

Merge pull request #16908 from twbs/crbug-309483

Remove http://crbug.com/309483 from the Wall of Browser Bugs
```

たしかに、現在、`5c028448c1fc171cf4a0fd99d3a672b649bef2aa` にいることがわかります。


## Submodule を更新する

いま追加した Bootstrap は、master ブランチの最新のコミットでした。
プロジェクトでは、別のブランチの Bootstarp が使いたくなったとします。たとえば、現在進行中の `14226-rebased` ブランチを使いたいとしましょう。 (このブランチ名等は、タイミングや、Submodule に追加するプロジェクトによって変わりますので、適宜読み替えてください)

このときの手順は、

* submodule のディレクトリに入り、対象のブランチやコミットをチェックアウトする
* submodule の外側に戻り、その submodule の現在のコミットを記録する (指し示す先を変更する)

という手順になります。

```bash:
$ cd bootstrap
$ git branch -a
* master
remotes/origin/14226-rebased
remotes/origin/HEAD -> origin/master
remotes/origin/bhamodi-update-dependencies
remotes/origin/bundler
remotes/origin/derp
remotes/origin/fix-15534
remotes/origin/fix-popover-setContent
remotes/origin/gh-pages
remotes/origin/master
remotes/origin/travis2

$ git checkout 14226-rebased
Branch 14226-rebased set up to track remote branch 14226-rebased from origin.
Switched to a new branch '14226-rebased'
```

この状態で外に戻ると、

```bash:
$ cd ..
$ git status
Changes not staged for commit:
(use "git add <file>..." to update what will be committed)
(use "git checkout -- <file>..." to discard changes in working directory)

modified: bootstrap (new commits)

no changes added to commit (use "git add" and/or "git commit -a")
```

bootstrap ディレクトリに diff が出た状態となっています。

```diff:
$ git diff
diff --git a/bootstrap b/bootstrap
index 5c02844..88697c0 160000
--- a/bootstrap
+++ b/bootstrap
@@ -1 +1 @@
-Subproject commit 5c028448c1fc171cf4a0fd99d3a672b649bef2aa
+Subproject commit 88697c03a9315b5f1944fc82534a824aafebda0e
```

これが、submodule がコミットを記録する仕組みで、つまり、

* リポジトリAの参照する Bootstrap のコミットが、`5c028448c1fc171cf4a0fd99d3a672b649bef2aa` から `88697c03a9315b5f1944fc82534a824aafebda0e` に変更されたという意味になります。

これを add してコミットしておきます

```bash:
$ git add bootstrap
$ git commit -m "Update submodule: Bootstrap"
```


## リポジトリAで別のコミットをチェックアウトする & git submodule update

submodule のわかりづらい点としては、おそらく、**リポジトリA (submodule の外側) と submodule の中が連動しない** という点ではないでしょうか。

たとえば、今の状態で、リポジトリAでひとつ前のコミットをチェックアウトしてみるとします。(今回はミニマムなgitリポジトリなので直前のコミットをチェックアウトしますが、実際いろいろな作業では、他のブランチをチェックアウトしたり、そういう操作の例として、です)

まずは、チェックアウトするため、ログを確認。

```bash:
$ git log --oneline
284ffed Update submodule: Bootstrap
45db3c1 Add Twitter Bootstrap as a submodule
30ef9ed initial commit
```

一つ前なので、 `45db3c1` をチェックアウトします。

```bash:
$ git checkout 45db3c1
...
HEAD is now at 45db3c1... Add Twitter Bootstrap as a submodule
```

この状態で status を見てみると、

```bash:
$ git status
HEAD detached at 45db3c1
Changes not staged for commit:
(use "git add <file>..." to update what will be committed)
(use "git checkout -- <file>..." to discard changes in working directory)

modified: bootstrap (new commits)

no changes added to commit (use "git add" and/or "git commit -a")
```

あれ！bootstrap ディレクトリに diff がでてしまいました。
これが、**連動しない、というわかりにくい点** と言った点です。

* 外側のリポジトリで前のコミットをチェックアウトしたため、そのコミット時点での submodule としての bootstrap は `5c028448c1fc171cf4a0fd99d3a672b649bef2aa` が記録されている
* しかし、bootstrap の内側は、先程操作したため、`88697c03a9315b5f1944fc82534a824aafebda0e` を指し示したまま

という状態になっています。リポジトリA上で色々なブランチやコミットを移動しても、submodule 内は自動的にチェックアウトされたりはしないんですよね。
そこで、

* boostrapディレクトリ内を、コミット `88697c0` が指し示している bootstrap のコミット `5c02844` にする

という操作が、

```bash:
$ git submodule update
```

というコマンドになります。submodule update というコマンド名は、「submoduleを更新する」という意味なので、考えてみればそのままの意味なのですが、わかってないと混乱してしまいますね。

これで、

```bash:
$ git status
```

が clean な状態となり、 bootstrap ディレクトリの中に入って確認してみると、`5c02844` がチェックアウトされた状態になっています。


## まとめとその他のこと

時間がなくなってきたので強引にまとめに入ると、

* submodule として追加したディレクトリは、ただの外部リポジトリへ参照を記録した箱である
* submodule の外側は、その箱のどのコミットを参照しているのかを記録している
* submodule の内側は、基本的には、自分が操作したときにしか更新されない

よくある現象集:

* git pull したら submodule に `(new commits)` とか出た
* これは、自分以外の誰かが submodule を更新した (指し示すコミットを変更した) 場合です
* さっきの、`0a30745` をチェックアウトしたときと同じ
* `git submodule update` すれば、その指し示すコミットがチェックアウトされる
* git status したら submodule に `(modified content)` とか出てる
* これは、submodule 内に diff がある状態です。今回の例で言えば、bootstrapディレクトリ内のなにかのファイルを変更したりすると、リポジトリAではこういうふうにいわれます
* もとに戻したいなら、bootstrapディレクトリ内をcleanな状態にします。`git checkout`とかで変更ファイルをなくしたり。
* 中でコミットなどをすると、 `(new commits)` になります。
* submodule の中身を変更して、そのコミットをリポジトリAから指し示したい場合、さらに `git add bootstrap` して `git commit` します。内側でコミット、外側でもそれをコミット、という形

あとなんだっけ、もっと書きたいことがあったけど忘れたのでまた思い出したら書きます。

皆さん、tigコマンドを活用していますか？
tigは、コンソール上で使えるgitブラウザです。実はずっと、ただのきれいな`git log`だと思っていたのですが、本当はそんなことはありません。かなり使えるやつなのです。

### インストール
ソースコード: https://github.com/jonas/tig
インストール方法: https://github.com/jonas/tig/blob/master/INSTALL.adoc
この辺りを参考にしてみてください。詳細は割愛します。

### 基本の使い方

この状態の差分を扱っていきます。いつものこれだとこんな感じ。

```
$ git status
```


```
$ tig
```


`git log`が素敵にビジュアライズされてます。この画面を`main view`といいます。
ここでエンターを押すと、下半分に差分の詳細（`diff view`）が表示されます。


下矢印で、Unstaged changesの差分を見てみるとこんな感じです。`git status`で `Changes not staged for commit`に表示されている部分の差分ですね。


ちなみに、この画面で`Ctrl+u`、`Ctrl+d`、`j`、`k`で上下移動できます。vimと同じですね。

また、`main view`にて`d`を押すと、コミット毎の差分の詳細（`diff view`）が全画面で表示されます。画面分割では見辛い場合にはこちらをどうぞ。


### tigでaddする
##### ファイルごと `u`
`main view`にて、`S`（`shift+s`）を押すと、次のように、`git status`の結果が表示されます。


この画面でも、エンターを押すとそのファイルの差分を閲覧できます。

好きなファイルを選択した状態で、`u`を押してみます。

`MusicLife/DetailViewController.m`が、`Changed but not updated:`から`Changes to be committed:`に移動しました。
これで、`git add MusicLife/DetailViewController.m`完了です！　超お手軽。

`Changes to be committed:`に表示されているファイル名の上で`u`を押すと、indexから外すこともできます。

##### 一部だけ `u`
さて、先ほどaddしたファイルの差分を見てみたら、まだcommitしたくない差分も混じっていました。


ここだけaddしなかったことにしたい…だけどそのためにファイルを修正するのは面倒です。
そんなときは、下の画像のように、「ここからここまで」の間の行（ **どの行でもOKです。** 自分で範囲選択する必要はありません）を選択して、`u`を押すと、その範囲だけadd/unstageすることができます。

その後の様子。部分的にaddされているため、同じファイルが上段と中段の両方に表示されています。



##### 1行だけ `1`

さっきの状態に戻って、今度は1行だけadd/unstageしてみようと思います。下の画像のように操作したい行を選択して、`1`を押します。


すると……


1行だけunstageされました。画面上部の`Changed but not updated:`にもファイル名が表示されています。

このように、tigを使うことによって、細かなコミット管理が簡単に行えるようになります！

### tigでcommitする `C`

`status view`の画面で、`C`（`shift+c`）を押します。


いつもの`git commit`の画面ですね！ いつも通り、1行目にコミットメッセージを書いて`:wq`すればokです。
なお、そこから`main view`に戻ってきても今作ったコミットは表示されていないと思うのですが、`R`（`shift+r`）か`F5`して更新すれば表示されます。

### tigでpushする

addとcommitが出来るならpushも、と思って調べてみたのですが、今のところ出来ません。

https://github.com/jonas/tig/issues/199

いいキーバインドがないこと、誤ってリモートリポジトリに修正を加えてしまうことへの不安などが、現在実装されていない理由のようですね。上記Issueで作者の方が書いている方法で、tig上でpushを行うこともできるようですので、tig上で全て完結させたい方は試してみてください。

### tigでbranch一覧を見る

`main view`で`H`（`shift+h`）を押すと、branchの一覧が表示されます。いちばん上が現在のブランチ、中央の青字がローカルブランチ、下のオレンジ色がリモートブランチです。右はそれぞれのブランチの最後のコミットメッセージです。



### 他にも色々できる！
`main view`にて`h`を押すとヘルプ画面になります。上に挙げた以外にも色々なことができるので、ぜひ試してみてください。

```
[-] status bindings
External commands:
'C' `git commit`
[-] branch bindings
External commands:
'C' `git checkout %(branch)`
[-] main bindings
External commands:
'C' `git cherry-pick %(commit)`
[-] generic bindings
View switching
'm' view-main Show main view
'd' view-diff Show diff view
'l' view-log Show log view
't' view-tree Show tree view
'f' view-blob Show blob view
'B' view-blame Show blame view
'H' view-branch Show branch view
'h' view-help Show help view
'p' view-pager Show pager view
'S' view-status Show status view
'c' view-stage Show stage view

（以下略）
```

今から Android やるならチェックしておきたい、厳選イカしたオープンソースライブラリ一覧。

support-v4 や support-v7-appcompat などは公式のものなので割愛。

# 開発環境

## Android SDK

- [Android SDK Installer](https://github.com/embarkmobile/android-sdk-installer)

公式からダウンロードしてポチポチとチェックを入れてはダウンロードして…が面倒くさいならコレ。
シェルからコマンド一発でダウンロード出来るので、CI で使うのにも便利。

- [ADB Idea](https://github.com/pbreault/adb-idea)

AndroidStudio および IntelliJ 用のプラグインで、IDE から ADB コマンドを簡単に利用できるようにするためのもの。メニューから選択してコマンドを実行できるようにしてくれる。

# コード最適化

## DI コンテナ

- [Dagger](https://github.com/square/dagger)

square 社の Android および Java 向け DI コンテナ。
`javax.inject.Inject` アノテーションを使う。
コンパイル時にコードを生成する。

- [Proton](https://github.com/hnakagawa/proton)

Android 向け DI コンテナ。
`javax.inject.Inject` アノテーションを使う。
実行時にインスタンスを注入する。

- [ButterKnife](https://github.com/JakeWharton/butterknife)

View のインジェクションに特化している。

- [RoboGuice](https://github.com/roboguice/roboguice)

Google が提供する Guice の Android 向けラッパー。
`javax.inject.Inject` アノテーションを使う他、独自にインジェクション用のアノテーションも提供している。

## View の生成

- [Michelangelo](https://github.com/RomainPiel/Michelangelo)

アノテーションを用いてカスタムビューのコードを整理できる。
ビューがインフレートされた後に実行したい処理をアノテーションで示すことも出来る。

## リソース

- [Paraphrase](https://github.com/JakeWharton/paraphrase)

文字列リソースのフォーマットをよりリーダブルに、かつデバッガブルにするためのライブラリ。
文字列リソースのフォーマットに関するプログラミングのエラーが、ランタイムではなくコンパイル時に判明するようになる。

## ユーティリティ

- [AndroidAnnotations](https://github.com/excilys/androidannotations)

アノテーションを使って、コンパイル時にコードを自動生成させることで、プログラマの書くコード量を減らすライブラリ。
DI コンテナとして、View やシステムサービス、リソース、Intent に含まれる Extra を注入することが出来る他、メソッドがメインスレッドで実行されるかバックグラウンドスレッドで実行されるかも制御できる。

- [Amalgam](https://github.com/nohana/Amalgam/)

Apache Commons のような Commons ライブラリで、Android 用。
`Context#getSystemService(String)` のラッパーや、各種 Manager 類のラッパーがある。

- [Guava](https://github.com/google/guava)

Apache Commons のような Commons ライブラリ。
Java 向けに各種のユーティリティが取り揃えられている。

## 機種依存解決

- [AndroidDeviceCompatibility](https://github.com/mixi-inc/Android-Device-Compatibility)

機種ごとの依存を吸収する為のライブラリ。

## モジュール化

- [android-promise](https://github.com/hnakagawa/android-promise)

非同期な処理をモジュール化する為のライブラリ。

# UI コンポーネント

## Pull to refresh

- [ActionBar PullToRefresh](https://github.com/chrisbanes/ActionBar-PullToRefresh)

引っ張ると ActionBar に更新の表示が出る UI コンポーネント。

- [Android PullToRefresh](https://github.com/chrisbanes/Android-PullToRefresh/)

Twitter スタイルの引っ張り更新の UI コンポーネント。
現在メンテは終了しており、使うのであれば、上記の ActionBar PullToRefresh を使うほうが良い。

## ActionBar

- [FadingActionBar](https://github.com/ManuelPeinado/FadingActionBar)

ActionBar にフェードアウト効果を適用するためのライブラリ。

- [GlassActionBar](https://github.com/ManuelPeinado/GlassActionBar)

ActionBar に透かし窓のような効果を適用するためのライブラリ。

## WebView

- [Chromium WebView](https://github.com/mogoweb/chromium_webview)

KitKat で導入された、Chromium エンジンの WebView のバックポートライブラリ。
これを使えば、OS バージョンや機種ごとの WebKit の実装依存問題が解決できるかもしれない。

## Text・Font

- [emojicon](https://github.com/rockerhieu/emojicon)

TextView 上に絵文字を表示するためのライブラリ。

- [IonIconView](https://github.com/MarsVard/IonIconView)

ionicons.com で提供されているアイコンを View に表示可能にするライブラリ。

- [Android Iconify](https://github.com/JoanZapata/android-iconify)

FontAwesome の各種フォントをアプリ内で使えるようにするライブラリ。

- [Calligraphy](https://github.com/chrisjenx/Calligraphy)

カスタムフォントを容易に扱えるようにしてくれるライブラリ。

## Calendar

- [ExtendedCalendarView](https://github.com/tyczj/ExtendedCalendarView)

カレンダーのコンテンツを保持する DB とセットで、イベントを表示できるカレンダー View を提供してくれるライブラリ。

- [GoogleCalendarView](https://github.com/tyczj/GoogleCalendarView)

Google 公式のカレンダーアプリからのバックポート。

## エフェクト

- [Android StackBlur](https://github.com/kikoso/android-stackblur)

Bitmap にブラーのエフェクトをかける。

- [GPUImage Android](https://github.com/CyberAgent/android-gpuimage)

iOS 向けに作られていた GPU Image の Android 移植版。

## 通知

- [SuperToasts](https://github.com/JohnPersano/SuperToasts)

Toast を拡張して、ボタンを置いたり見た目を少し変えたりすることが出来るようになるライブラリ。

- [Crouton](https://github.com/keyboardsurfer/Crouton)

標準の Toast の代替として、Context に依存してカスタム可能な Toast を提供する。

## レイアウト

- [ImageLayout](https://github.com/ManuelPeinado/ImageLayout)

画像の上に View を配置するための特別なレイアウトコンポーネント。
独自の座標系を持って管理している。

## ListView・GridView

- [StickyListHeaders](https://github.com/emilsjolander/StickyListHeaders)

Instagram のような、ListView のスクロールに追従してくるヘッダを提供する。

- [StickyGridHeaders](https://github.com/TonicArtos/StickyGridHeaders)

上記ライブラリの GridView 版。

- [Android StaggeredGrid](https://github.com/etsy/AndroidStaggeredGrid)

高さの異なるグリッドを扱える。

- [AdapterView Animator](https://github.com/SimonVT/adapterviewanimator)

AdapterView の行を追加したときのアニメーションを実現するヘルパライブラリ。

- [cwac-touchlist](https://github.com/commonsguy/cwac-touchlist)

List のドラッグ・アンド・ドロップを実現するライブラリ。

## ViewPager

- [JazzyViewPager](https://github.com/jfeinstein10/JazzyViewPager)

スワイプ時のアニメーションをカスタマイズできる。

- [Android ViewPagerIndicator](https://github.com/JakeWharton/Android-ViewPagerIndicator)

ViewPager に追随して位置表示する View。

## Dialog

- [Android Styled Dialogs](https://github.com/inmite/android-styled-dialogs)

ダイアログにテーマでスタイルを適用出来るようにするためのライブラリ。

## ImageView

- [CustomShape ImageView](https://github.com/MostafaGazar/CustomShapeImageView)

画像をくり抜いて、様々な形に出来る ImageView。

- [Rounded ImageView](https://github.com/vinc3m1/RoundedImageView)

角丸の ImageView を作れるライブラリ。

- [PhotoView](https://github.com/chrisbanes/PhotoView)
- [ImageViewZoom](https://github.com/sephiroth74/ImageViewZoom)

画像の拡大縮小機能を持つ ImageView。

## チャート

- [Holo Graph Library](https://bitbucket.org/danielnadeau/holographlibrary)

Holo スタイルのグラフ・チャートを作るライブラリ。

- [AChartEngine](https://code.google.com/p/achartengine/)

こちらも、グラフ・チャートを作るライブラリ。

## Interaction

- [Android Swipe To Dismiss](https://github.com/romannurik/Android-SwipeToDismiss)

View をスワイプして消す操作を実現するライブラリ。

- [EnhancedListView](https://github.com/timroes/EnhancedListView)

Gmail のように、行をスワイプすることで削除を実行するインタラクションを実現でき、かつ、Undo の機能も有する ListView の拡張。

## その他

- [Android Sliding Up Panel](https://github.com/umano/AndroidSlidingUpPanel)

Google Play Music のように、下からせり出してくるパネルを表示するライブラリ。

- [CardsLib](https://github.com/gabrielemariotti/cardslib)

カード UI を構築するためのライブラリセット。

- [ProgressWheel](https://github.com/Todd-Davies/ProgressWheel)

ぐるぐる回るプログレスバーをカスタマイズするライブラリ。

- [Android Bootstrap](https://github.com/Bearded-Hen/Android-Bootstrap)

FontAwesome と共に Bootstrap スタイルのボタン類を使えるようにするライブラリ。

- [Android Satellite Menu](https://github.com/siyamed/android-satellite-menu)

Path みたいなメニューを構築するライブラリ。

- [NineOldAndroids](https://github.com/JakeWharton/NineOldAndroids)

API 11 から登場したアニメーションフレームワークをバックポートするライブラリ。

- [Holo Everywhere](https://github.com/Prototik/HoloEverywhere)

Holo テーマのバックポートライブラリ。

- [Holo ColorPicker](https://github.com/LarsWerkman/HoloColorPicker)

色を選択する View のライブラリ。

- [Android Validator](https://github.com/throrin19/Android-Validator)

入力のバリデーションのためのライブラリ。

- [android-gifview](https://code.google.com/p/android-gifview/)

Gif アニメーションを再生可能な View のライブラリ。

# シリアライズ

## Json

- [Google Gson](https://code.google.com/p/google-gson/)

リフレクションによってマッピングするライブラリ。

- [Jackson](http://jackson.codehaus.org/)

超高速にシリアライズ・デシリアライズできるライブラリ。

# データベース

## ORM

- [GreenDAO](https://github.com/greenrobot/greenDAO)

グリーンだよ！いいんだよ！

スキーマ、エンティティをそれぞれ定義するクラスを使ってマッピングする。

- [Active Android](https://github.com/pardom/ActiveAndroid)

エンティティクラスの宣言にアノテーションを付けてマッピングする。

# イベントバス

使い方は[こちら](http://qiita.com/KeithYokoma/items/793aaac6994c9242808f)。

- [otto](https://github.com/square/otto)

Guava ベースの Android 向け軽量イベントバス。

- [EventBus](https://github.com/greenrobot/EventBus)

otto より機能的に拡張のあるイベントバス。

# デバッグ支援

## View

- [scalpel](https://github.com/JakeWharton/scalpel)

View の階層構造を 3D 表示するためのツール。

## リソース

- [Madge](https://github.com/JakeWharton/madge)

Bitmap がオリジナルのサイズで表示されているかどうかを一目見て分かるようにする。

## クラッシュログ

- [Native Crash Handler](https://github.com/SalomonBrys/Native-Crash-Handler)

Native コードのエラーハンドリングとして、SIGSEGV などを検出して Java の例外を生成してくれる。
これによって、Google Play などで拾いきれなかったクラッシュのログを収集できるようになる。

## ログ出力

- [hugo](https://github.com/JakeWharton/hugo)

アノテーションによるメソッドコールのロギングライブラリ。

- [deploygate](http://deploygate.com/)

ログ収集だけでなく、apk の配布までも楽ちんにしてくれるサービス。
sdk を組み込めばかなりのことが Web コンソール上で出来る。

# 画像

## 画像読み込み・キャッシュ

- [Android Universal Image Loader](https://github.com/nostra13/Android-Universal-Image-Loader)

各種設定に基いて画像の読み込み・キャッシュ・表示をしてくれるライブラリ。

- [picasso](https://github.com/square/picasso)

メソッドチェーンによる画像読み込み・キャッシュ・表示の為のライブラリ。

## 加工

- [CropImage](https://github.com/biokys/cropimage)

画像の切り抜きをサポートするライブラリ。

# ハイブリッドアプリケーション開発

ネイティブ実装をベースに、JavaScriptInterface と連携してハイブリッドアプリケーションを開発するフレームワーク。

- [Hybridge](https://github.com/rejasupotaro/Hybridge)
- [triaina](https://github.com/mixi-inc/triaina)

# テスト

## テストユーティリティ

- [fest-android](https://github.com/square/fest-android)

Android のテストに FEST を導入できる。

- [robolectric](https://github.com/robolectric/robolectric)

Android のテストの高速化

- [Robotium](https://code.google.com/p/robotium/)

UI のテストを Selenium のようにかける、かつ Android フレームワークが持つ UI テストフレームワークを拡張している。

## モック

- [Mockito](https://code.google.com/p/mockito/)

いろんなものをモックするためのライブラリ。

- [RobotGirl](https://github.com/rejasupotaro/RobotGirl)

ActiveAndroid 向けのフィクスチャライブラリ。

# 通信

## REST

- [Retrofit](https://github.com/square/retrofit)
- [RoboZombie](https://github.com/sahan/RoboZombie)

REST クライアントを簡単に生成するためのライブラリ。


## Http通信・SPDY

- [okhttp](https://github.com/square/okhttp)

http(s) 通信 と SPDY に対応したクライアント。

- [volley](https://android.googlesource.com/platform/frameworks/volley/)

通信処理をいろいろ便利にしてくれるユーティリティ。

# ビルドスクリプト

## Gradle

- [Gradle Android Utils](https://github.com/gfx/gradle-android-utils)

ビルドスクリプトのユーティリティ集。

- [Gradle MVN Push](https://github.com/chrisbanes/gradle-mvn-push)

Maven Repository に aar な成果物を push するヘルパ。

- [Gradle Android Test Plugin](https://github.com/JakeWharton/gradle-android-test-plugin)

Gradle で Android のテストを実行するためのヘルパプラグイン。

# その他便利系

## アップデートチェック

- [UpdateChecker](https://github.com/rampo/UpdateChecker)

アップデートがあった時にダイアログを出す。

## レビュー

- [RateThisApp](https://github.com/kskkbys/Android-RateThisApp)

レビューを促すダイアログを出す。

## Job Queue

- [Priority JobQueue](https://github.com/path/android-priority-jobqueue)

優先度付きのジョブキュー

- [nirai](https://github.com/jfsso/nirai)

IntentService によるジョブキューの仕組み。
詳しくは[こちら](http://qiita.com/jfsso/items/106f48de7ec0612038bb)

## SharedPreferences

- [esperandro](https://github.com/dkunzler/esperandro)

SharedPreferences のラッパー。